Informer Kubernetes Visibility Agent (KVA) インストール
Kubernetes ヴィジビリティエージェント Informer は、Helm チャートまたは Kubernetes YAML ファイルを使用してインストールできます。
始める前に
必要なロール:なし
このタスクについて
この手順では、標準的な Kubernetes ヴィジビリティエージェント Informer インストールプロセスについて説明します。通常、Helm チャートを使用してインストールを実行しますが、ServiceNow が提供する Kubernetes YAML ファイルを構成して実行することもできます。
手順
Helm チャートまたは ServiceNow が提供する Kubernetes YAML ファイルを使用して、Kubernetes ヴィジビリティエージェント Informer をインストールします。
-
Helm チャートを使用して Kubernetes ヴィジビリティエージェント Informer をインストールします。
- Helm install コマンドを編集します。
- 次のコマンドで、NAMESPACE、INSTANCE_NAME、および CLUSTER_NAME を関連する値に置き換え、HELM_URL を、Now Support ナレッジベースの Kubernetes Visibility Agent (以前の CNO for Visibility) Helm Chart および Kubernetes YAML ファイルリリース [KB1564347] の記事で提供されている最新バージョンの URL に置き換えます。
helm install -n NAMESPACE --set acceptEula=Y --set instance.name=INSTANCE_NAME --set clusterName="CLUSTER_NAME" {--set image.repository=COMPANY_REPO --set image.tag=COMPANY_TAG} {--set proxyUrl=http://proxy_host:proxy_port} k8s-informer HELM_URL注:- 中括弧は、囲まれているコードセグメントがオプションであることを示します。組織のイメージリポジトリからイメージをプルする必要がある場合、またはクラスターからの送信トラフィックがプロキシを経由する場合は、これらのコードセグメントを使用します。
--set acceptEula=Yを渡すと、エンドユーザーライセンス契約に同意したことになります。エンドユーザーライセンス契約を読むには、informer-helm-<VERSION_NUMBER>.tgz から EULA.pdf を抽出します。- Informer が OpenShift にインストールされている場合は、コマンドに openShift パラメーターを追加して true に設定します。
helm install -n NAMESPACE --set acceptEula=Y --set instance.name=INSTANCE_NAME --set clusterName="CLUSTER_NAME" {--set image.repository=COMPANY_REPO --set image.tag=COMPANY_TAG} {--set proxyUrl=http://proxy_host:proxy_port} {--set openShift=true} k8s-informer HELM_URL注:Informer が OpenShift にインストールされていない場合は、このパラメーターを設定する必要はありません。 - ハイブリッドサービスマップを使用して Kubernetes クラスターの内部と外部の両方のリソースをマップする場合は、次のパラメーターを設定します。
--set bringIngressAddresses=true --set bringNodeExternalIPs=true --set discoverK8sServiceExternalIps=true --set openShift=true
- コマンドで、必要に応じて追加の設定を構成します。
- Informer ポッドのメモリ制限の設定
- Kubernetes ヴィジビリティエージェント での完全ディスカバリー頻度の変更
- Kubernetes ヴィジビリティエージェント での継続的なディスカバリーの非アクティブ化
- Kubernetes クラスターの頻繁な変更を抑制して、インスタンスの負荷を軽減します。この機能がアクティブな場合、Informer は設定されたしきい値を超える変更をインスタンスに報告しません。詳細については、Now Support ナレッジベースの記事「Kubernetes Visibility Agent (旧称 CNO for visibility) [KB1580745] によって報告される Kubernetes クラスタの頻繁な変更の抑制 (Suppressing frequent changes reported by Kubernetes Visibility Agent (旧称 CNO for visibility) [] を参照してください。
- Informer が複数のクラスターで同時に実行できる完全ディスカバリーの最大数を制御します。詳細については、Now Support ナレッジベースの記事「Kubernetes Visibility Agent (旧 CNO for Visibility) [KB1580250] での完全なディスカバリーのスケジュール」を参照してください。
- アプリケーションサービスマップの有効化
- 次のコマンドで、NAMESPACE、INSTANCE_NAME、および CLUSTER_NAME を関連する値に置き換え、HELM_URL を、Now Support ナレッジベースの Kubernetes Visibility Agent (以前の CNO for Visibility) Helm Chart および Kubernetes YAML ファイルリリース [KB1564347] の記事で提供されている最新バージョンの URL に置き換えます。
- コマンドを実行します。
- Helm install コマンドを編集します。
- Kubernetes YAML ファイルを使用して Kubernetes ヴィジビリティエージェント Informer をインストールします。
- Now Support ナレッジベースの「Kubernetes Visibility Agent (旧称 CNO for Visibility) Helm チャート」の記事と Kubernetes YAML ファイルリリース [KB1564347] で提供されている Kubernetes YAML zip ファイルをダウンロードします。
- zip ファイルから k8s_informer.yaml ファイルと EULA.pdf ファイルを抽出します。
- k8s_informer.yaml ファイルを編集します。
- 次のように、ACCEPT_EULA の値を "Y" に変更します。
- name: ACCEPT_EULA value: "Y"注:値を "Y" に変更すると、EULA.pdf ファイルに含まれるエンドユーザーライセンス契約に同意したことになります。 - 出現するすべての <NAMESPACE> を、Informer をインストールする名前空間に置き換えます。
- 出現するすべての <INSTANCE_NAME> を、ドメイン名を含まないインスタンスの名前に置き換えます。
- <CLUSTER_NAME> は、CMDB に表示されるクラスターの名前に置き換えます。
- Informer が OpenShift にインストールされている場合は、OPENSHIFT 環境変数の値を true に変更します。
- アプリケーションサービスマップの有効化
- 次のように、ACCEPT_EULA の値を "Y" に変更します。
- ハイブリッドサービスマップを使用して Kubernetes クラスターの内部と外部の両方のリソースをマップする場合は、次のパラメーターを設定します。
- name: BRING_INGRESS_ADDRESSES value: "true" - name: BRING_NODE_EXTERNAL_IPS value: "true" - name: DISCOVER_K8S_SERVICE_EXTERNAL_IP value: "true" - name: OPENSHIFT value: "true" - 次のコマンドを実行します。
kubectl apply -f k8s_informer.yaml
タスクの結果
Kubernetes ヴィジビリティエージェント が Kubernetes クラスターに展開され、インスタンスへのデータストリーミングを開始します。
次のタスク
Kubernetes ヴィジビリティエージェント管理とトラブルシューティングの詳細については、Now Support ナレッジベースの「Kubernetes Visibility Agent (旧称 CNO for Visibility) の管理とトラブルシューティング」[KB1532614] の記事を参照してください。