|
この文書は自動機械翻訳技術を使用して翻訳されています。 正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。 相違がある場合は、元の英語版 英語 が優先され、正式なテキストとなります。 |
SUSE® Observabilityのインストール
始める前に
|
インストールに関する追加の注意事項：
|
SUSE® Observabilityのインストールを開始する前に：
helm repo add suse-observability https://charts.rancher.com/server-charts/prime/suse-observability
helm repo updateSUSE® Observabilityのインストール
|
インターネットアクセスのない環境、いわゆるエアギャップ(された)環境の場合、最初にこれらの追加の手順に従ってください。 また、ステップに対してエアギャップ(された)インストール手順が存在する場合は、それに従うことを確認してください。 |
名前空間を作成する
SUSE® Observabilityをインストールしたい名前空間を作成し、その名前空間にシークレットをデプロイします。私たちのウォークスルーでは、名前空間`suse-observability`を使用します：
kubectl create namespace suse-observability`values.yaml`設定ファイルを作成します。
`values.yaml`ファイルには、ライセンスキー、ベースURL、管理者パスワード、サイズプロファイルを含む、SUSE® Observabilityをデプロイするために必要なすべての設定が含まれています。
|
続行する前に：`helm repo update`を使用した最新のHelmチャートを持っていることを確認してください。 |
-
推奨方法
-
レガシー方法（廃止）
|
`global.suseObservability`設定方法は`2.8.0`バージョンから利用可能です。以前のバージョンでは、レガシー方法を使用してください。 |
`values.yaml`設定構造を持つ`global.suseObservability`ファイルを作成します：
global:
# Optional: Override image registry (defaults to registry.rancher.com)
# Only needed for air-gapped environments or custom registries
# imageRegistry: "your-private-registry.example.com"
# Optional: Override storage class (uses cluster default if not set)
# storageClass: "your-storage-class"
suseObservability:
# Required: Your {stackstate-product-name} license key
license: "YOUR-LICENSE-KEY"
# Required: Base URL for {stackstate-product-name}
# Use http://localhost:8080 if ingress is not configured yet
baseUrl: "https://observability.example.com"
# Required: Sizing profile
# Available: trial, 10-nonha, 20-nonha, 50-nonha, 100-nonha,
# 150-ha, 250-ha, 500-ha, 4000-ha
sizing:
profile: "150-ha"
# Required: Plain text admin password
adminPassword: "your-password"
# Instead of adminPassword you can provide a bcrypt hashed password with adminPasswordBcrypt
# Generate with: htpasswd -bnBC 10 "" "your-password" | tr -d ':\n'
# adminPasswordBcrypt: "$2a$10$..."
# Optional: Receiver API key (auto-generated if not provided)
# receiverApiKey: "your-receiver-api-key"
# Optional: Pull secret for private registry
# pullSecret:
# username: "registry-user"
# password: "registry-pass"アフィニティ設定を含むその他の設定オプションについては、Kubernetesアフィニティの設定を参照してください。
|
この方法は廃止されています。新しいインストールの場合は、上記の推奨方法を使用してください。この方法を使用している既存のインストールについては、新しい設定形式に移行するために移行ガイドを参照してください。 |
別のHelmチャートを実行することで、SUSE® Observability設定ファイルを生成できます。これが`suse-observability/suse-observability-values`チャートです：
export VALUES_DIR=.
helm template \
--set license='<your license>' \
--set baseUrl='<suse-observability-base-url>' \
--set sizing.profile='<sizing.profile>' \
suse-observability-values \
suse-observability/suse-observability-values --output-dir $VALUES_DIRこのコマンドは、$VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml、$VALUES_DIR/suse-observability-values/templates/sizing_values.yaml、および`$VALUES_DIR/suse-observability-values/templates/affinity_values.yaml`のファイルを生成します。
|
SUSE® Observability管理者パスワードは、上記のコマンドによって自動生成され、生成された`basicConfig.yaml`ファイルのコメントとして出力されます。実際の値には、これらのパスワードの`bcrypt`ハッシュが含まれており、クラスター内のHelmリリースに安全に保存されます。 |
このチャートに渡すことができる値は次のとおりです。
| 設定 | 値 | 説明 |
|---|---|---|
基本設定を生成 |
|
`basicConfig_values.yaml`ファイルの生成をオンまたはオフにします。 |
受信者APIキー |
|
SUSE® Observabilityがエージェントからデータを受信するために使用するAPIキーです。これはプライベートに保つべき秘密のキーです。これを省略すると、ランダムなキーが生成されます。 |
ベースURL |
|
ここでもゾーンが追加されないよう、 |
ユーザ名とパスワード** |
|
SUSE® Observabilityがイメージを取得するために使用するユーザ名とパスワード。エアギャップ(された)環境では、これらはローカルコンテナレジストリのユーザ名とパスワードである必要があります。 |
ライセンスキー |
|
SUSE® Observabilityライセンスキー。 |
デフォルトパスワード |
|
デフォルトユーザー（ |
イメージレジストリ |
|
SUSE® Observabilityイメージがホストされているレジストリ。提供されない場合、デフォルト値は’registry.rancher.com’になります。エアギャップ(された)環境またはカスタムレジストリにのみ必要です。 |
プルシークレットユーザ名 |
|
SUSE® ObservabilityイメージがホストされているDockerレジストリからイメージを取得するために使用されるユーザ名。カスタムレジストリにのみ必要です。 |
プルシークレットパスワード |
|
SUSE® ObservabilityイメージがホストされているDockerレジストリからイメージを取得するために使用されるパスワード。カスタムレジストリにのみ必要です。 |
サイズ生成 |
|
`sizing_values.yaml`ファイルの生成をオンまたはオフにします。 |
サイズプロファイル |
|
OneOfトライアル、10-nonha、20-nonha、50-nonha、100-nonha、150-ha、250-ha、500-ha。これらのプロファイルに基づいて、`sizing_values.yaml`ファイルを生成し、SUSE® ObservabilityリソースのデフォルトサイズとHAまたはNon-HAモードでデプロイするための設定を含めることができます。例えば、10-nonhaは、Non-HAモードで10ノードクラスターを監視するためにNon-HA SUSE® Observabilityインスタンスをデプロイするための`sizing_values.yaml`を生成します。現在、Non-HAからHA環境への移行は不可能です。環境が約150ノードの観察を必要とする場合は、すぐにHAに移行する方が良いです。 |
ポッドアンチアフィニティ |
|
同じデータサービスのレプリカが異なるKubernetesノードにスケジュールされることを強制します。`HA`プロファイルにのみ適用されます。`true`または`false`のいずれか。デフォルトは`true`です - 異なるノードへのスケジューリングが強制されます。 |
|
生成された`basicConfig.yaml`および`sizing_values.yaml`ファイルを安全に保管してください。これらのファイルをアップグレードする際に再利用でき、時間を節約し、SUSE® Observabilityが同じAPIキーを使用し続けることを保証します。これは望ましいことであり、SUSE® Observabilityのエージェントや他のデータプロバイダーを更新する必要がないことを意味します。 スイッチ`basicConfig.generate=false`および`sizing.generate=false`を使用して、ファイルの以前に生成されたバージョンを`output-dir`に保持しながら、いずれかを無効にしてファイルを独立して再生成できます。 |
|
SUSE® Observability値チャートは、ポッドスケジューリングの動作を制御するためにメインのSUSE® Observabilityチャートと一緒に使用できるアフィニティ設定を生成します。詳細については、Configure Kubernetes Affinitiesのドキュメントを参照してください。 |
ストレージクラスを設定します（オプション）
SUSE® Observabilityが指定されていない場合、クラスターのデフォルトストレージクラスを使用します。この設定は、`global.storageClass`を`values.yaml`ファイルに設定することでオーバーライドできます。
-
推奨方法
-
レガシー方法（廃止）
特定のストレージクラスを使用する必要がある場合は、それを`values.yaml`ファイルの`global.storageClass`の下に追加してください。
global:
storageClass: "your-storage-class" # e.g., "local-path" for Rancher local-path provisioner
suseObservability:
# ... other configuration"storageClass"の設定を追加するには、`$VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml`ファイルを編集してください。
# Source suse-observability-values/templates/baseConfig_values.yaml
global:
storageClass: "your-storage-class" # Optional: override default storage classHelmを使用してSUSE® Observabilityをデプロイします。
SUSE® Observabilityの推奨デプロイメントは、冗長性のある多くのサービスが稼働する、運用準備完了の高可用性セットアップです。必要に応じて、各サービスが単一のレプリカのみを持つ非冗長セットアップでSUSE® Observabilityを実行することも可能です。このセットアップはテスト環境にのみ推奨されます。
エアギャップ環境の場合は、エアギャップインストールの指示に従ってください。
-
推奨方法
-
推奨方法（エアギャップ(された)）
-
レガシー方法（廃止）
-
レガシー方法（エアギャップ）
Kubernetes上でSUSE® Observabilityをデプロイするには：
-
デプロイする前に：
-
次のコマンドを使用して、`suse-observability`名前空間に最新のSUSE® Observabilityバージョンをデプロイします：
helm upgrade \
--install \
--namespace suse-observability \
--values values.yaml \
suse-observability \
suse-observability/suse-observabilityまたは、値ファイルなしで`--set`フラグを使用して直接デプロイします：
helm upgrade \
--install \
--namespace suse-observability \
--set global.suseObservability.license="YOUR-LICENSE-KEY" \
--set global.suseObservability.baseUrl="https://observability.example.com" \
--set global.suseObservability.sizing.profile="150-ha" \
--set global.suseObservability.adminPassword='$2a$10$...' \
suse-observability \
suse-observability/suse-observabilityKubernetes上でエアギャップ(された)セットアップでSUSE® Observabilityをデプロイするには：
-
デプロイする前に：
-
次のコマンドを使用して、`suse-observability`ネームスペースに最新のSUSE® Observabilityバージョンをデプロイします：
helm upgrade \
--install \
--namespace suse-observability \
--values local-docker-registry.yaml \
--values values.yaml \
suse-observability \
suse-observability/suse-observability|
この方法は廃止されています。新しいインストールの場合は、上記の推奨方法を使用してください。この方法を使用している既存のインストールについては、新しい設定形式に移行するために移行ガイドを参照してください。 |
Kubernetes上でSUSE® Observabilityをデプロイするには：
-
デプロイする前に：
-
次のコマンドを使用して、`suse-observability`ネームスペースに最新のSUSE® Observabilityバージョンをデプロイします：
helm upgrade \
--install \
--namespace suse-observability \
--values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \
--values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \
--values $VALUES_DIR/suse-observability-values/templates/affinity_values.yaml \
suse-observability \
suse-observability/suse-observability|
この方法は廃止されています。新しいインストールの場合は、上記の推奨方法を使用してください。この方法を使用している既存のインストールについては、新しい設定形式に移行するために移行ガイドを参照してください。 |
Kubernetes上でエアギャップ(された)セットアップでSUSE® Observabilityをデプロイするには：
-
デプロイする前に：
-
次のコマンドを使用して、`suse-observability`ネームスペースに最新のSUSE® Observabilityバージョンをデプロイします：
helm upgrade \
--install \
--namespace suse-observability \
--values local-docker-registry.yaml \
--values $VALUES_DIR/suse-observability-values/templates/baseConfig_values.yaml \
--values $VALUES_DIR/suse-observability-values/templates/sizing_values.yaml \
--values $VALUES_DIR/suse-observability-values/templates/affinity_values.yaml \
suse-observability \
suse-observability-A.B.C.tgzインストール後、SUSE® ObservabilityリリースはSUSE® Observabilityネームスペースにリストされ、すべてのポッドが稼働しているはずです：
# Check the release is listed
helm list --namespace suse-observability
# Check pods are running
# It may take some time for all pods to be installed or available
kubectl get pods --namespace suse-observabilitySUSE® Observability UIにアクセスします。
SUSE® Observabilityがデプロイされた後、すべてのポッドが稼働しているか確認できます：
kubectl get pods --namespace suse-observabilityすべてのポッドが起動したら、ポートフォワードを有効にできます:
kubectl port-forward service/<helm-release-name>-suse-observability-router 8080:8080 --namespace suse-observabilityイングレス設定のために、ingress_values.yaml ファイルを作成し、以下のコードを追加してください。
|
TLS設定のためにシークレットを設定することを忘れないでください。その方法の詳細については、kubectlのドキュメントを参照してください。 |
ingress:
enabled: true
class: ""
annotations:
nginx.ingress.kubernetes.io/proxy-body-size: "50m"
nginx.ingress.kubernetes.io/ssl-redirect: "true"
#if external dns (cloudflare and similars) configure:
#external-dns.alpha.kubernetes.io/target: <INGRESS_FQDN>
#external-dns.alpha.kubernetes.io/ttl: "60"
#end if
hosts:
- host: <SUSE_OBSERVABILITY_HOST>
tls:
- hosts:
- <SUSE_OBSERVABILITY_HOST>
secretName: suse-private-ai-tls
existingSecret: suse-private-ai-tls
# Set up your secrets in whichever way feels fit. Check k8s docs for details: https://kubernetes.io/docs/reference/kubectl/generated/kubectl_create/kubectl_create_secret_tls/イングレス設定を適用するためにアップグレードを実行してください:
-
アップグレード
-
エアギャップ(された)アップグレード
helm upgrade --namespace suse-observability --reuse-values --values ingress_values.yaml suse-observability suse-observability/suse-observabilityhelm upgrade --namespace suse-observability --reuse-values --values suse-observability-values/templates/ingress_values.yaml suse-observability suse-observability-A.B.C.tgz|
外部DNSを使用していない場合は、ローカルマシンの/etc/hostsに追加してください: <CLUSTER_IP> <SUSE_OBSERVABILITY_HOST>。 |
SUSE® Observabilityは、`https://localhost:8080`でブラウザで利用可能になります。ユーザー名`admin`と`baseConfig_values.yaml`ファイルに記載されているデフォルトのパスワードでログインしてください。
次のステップは