Helm チャートを使用したクラスタエージェントのインストール

このページでは、クラスタエージェントの Helm チャートを使用してクラスタエージェントを展開する方法について説明します。

Helm は Kubernetes のパッケージマネージャです。Helm チャートは、一連の Kubernetes リソースについて説明するファイルのコレクションです。クラスタエージェントの Helm チャートは、Splunk AppDynamics オペレータとクラスタエージェントを展開するのに便利な方法です。クラスタエージェントの Helm チャートを使用して、1 つのクラスタに複数のクラスタエージェントを展開することもできます。これは、単一のクラスタエージェントのポッドモニタリング制限を超える大規模なクラスタで必要になることがあります。「クラスタエージェントの要件およびサポート対象環境」を参照してください。

要件

• クラスタ エージェント バージョン 20.6 以降
• コントローラバージョン 20.6 以降
• クラスタエージェントの Helm チャートが Helm 3.0 と互換性を持っている

クラスタへの単一のクラスタエージェントのインストール

1. 次のコマンドを使用して、Splunk AppDynamics エージェントに関連する、以前にインストールされたすべての CustomResourceDefinition（CRD）を削除します。

   CODECopy

   $ kubectl get crds $ kubectl delete crds <crd-names>

   $ kubectl get crds 
   $ kubectl delete crds <crd-names>

2. チャートリポジトリを Helm に追加します。

   CODECopy

   helm repo add appdynamics-cloud-helmcharts https://appdynamics.jfrog.io/artifactory/appdynamics-cloud-helmcharts/

   helm repo add appdynamics-cloud-helmcharts https://appdynamics.jfrog.io/artifactory/appdynamics-cloud-helmcharts/

3. クラスタで appdynamics の名前空間を作成します。

   CODECopy

   kubectl create namespace appdynamics

   kubectl create namespace appdynamics

4. values-ca1.yaml の例では、Helm 値ファイルを作成します。コントローラのログイン情報を使用して controllerInfo プロパティを更新します。clusterAgent プロパティを更新して、モニターする名前空間とポッドを設定します。使用可能なプロパティ nsToMonitorRegex、nsToExcludeRegex、および podFilter の詳細については、「クラスターエージェントの設定」を参照してください。

   values-ca1.yaml

   CODECopy

   # To install Cluster Agent installClusterAgent: true # controller info controllerInfo: url: https://<controller-url>:443 account: <appdynamics-controller-account> username: <appdynamics-controller-username> password: <appdynamics-controller-password> accessKey: <appdynamics-controller-access-key> # Cluster agent config clusterAgent: nsToMonitorRegex: dev-.*

   # To install Cluster Agent 
   installClusterAgent: true
   
   
   # controller info
   controllerInfo:
     url: https://<controller-url>:443
     account: <appdynamics-controller-account>                   
     username: <appdynamics-controller-username>                          
     password: <appdynamics-controller-password>                                 
     accessKey: <appdynamics-controller-access-key>  
   
   # Cluster agent config
   clusterAgent:
     nsToMonitorRegex: dev-.*

   注: クラスタエージェント 24.9 以降では、ポッドの削除時に関連ノードを履歴としてマークするためのサーバーモニタリングユーザーのログイン情報または API ユーザーログイン情報は必要なくなりました。ポッドが削除されると、コントローラの関連ノードは自動的に履歴としてマークされます。
   使用可能なオプションの詳細については、「values.yaml の設定オプション」を参照してください。また、次のコマンドを使用して、Helm チャートリポジトリから values.yaml のコピーをダウンロードできます。
   CODECopy

   helm show values appdynamics-cloud-helmcharts/cluster-agent

   helm show values appdynamics-cloud-helmcharts/cluster-agent

5. （オプション）複数のクラスターエージェントで単一のクラスターをモニターする必要がある場合は、ターゲットアロケータを設定します。オペレータがクラスターエージェントのレプリカを作成できるようにするには、values-ca1.yaml ファイルで、クラスタエージェントのレプリカの数を使用してターゲットアロケータを有効にします。
   values-ca1.yaml

   JSONCopy

   ... # Cluster agent config clusterAgent: nsToMonitorRegex: dev-.* #Instrumentation config instrumentationConfig: enabled: false # Target allocator Config targetAllocator: enabled: true clusterAgentReplicas: 3 autoScaling enabled: false #false by default replicaProfile: Default maxClusterAgentReplicas: 12 scaleDown: stabilizationWindowSeconds: 86400 #In Seconds # Target Allocator pod specific properties targetAllocatorPod: imagePullPolicy: "" imagePullSecret: "" priorityClassName: "" nodeSelector: {} tolerations: [] resources: limits: cpu: "500m" memory: "500Mi" requests: cpu: "200m" memory: "200Mi" labels: {} securityContext: {}

   ...  
   
   # Cluster agent config
   clusterAgent:
     nsToMonitorRegex: dev-.*
   
   #Instrumentation config
   instrumentationConfig:
     enabled: false
   
   # Target allocator Config
   targetAllocator:
     enabled: true
     clusterAgentReplicas: 3
     autoScaling
       enabled: false #false by default
       replicaProfile: Default 
       maxClusterAgentReplicas: 12
       scaleDown:
         stabilizationWindowSeconds: 86400 #In Seconds
   
   # Target Allocator pod specific properties
   targetAllocatorPod:
     imagePullPolicy: ""
     imagePullSecret: ""
     priorityClassName: ""
     nodeSelector: {}
     tolerations: []
     resources:
       limits:
         cpu: "500m"
         memory: "500Mi"
       requests:
         cpu: "200m"
         memory: "200Mi"
     labels: {}
     securityContext: {}

   ターゲットアロケータの詳細については、「ターゲットアロケータ」を参照してください。
6. （オプション）コントローラアクセスキーに基づいてシークレットを作成します。create-secret-accesskey
   CODECopy

   kubectl -n appdynamics create secret generic cluster-agent-secret --from-literal=controller-key='<access-key>' --from-literal=api-user='<username@account:password>'

   kubectl -n appdynamics create secret generic cluster-agent-secret --from-literal=controller-key='<access-key>' --from-literal=api-user='<username@account:password>'

7. クラスタ（通常は kube-system 名前空間に配置）に Kubernetes metrics-server をインストールしていない場合は、値ファイルで install.metrics-server を true に設定し、サブチャートを呼び出してインストールします。

   CODECopy

   install: metrics-server: true

   install:
     metrics-server: true

   注: install.metrics-server を設定すると、--namespace フラグが付いた名前空間に metrics-server がインストールされます。この名前空間は、クラスタエージェントと同じです。

8. クラスタエージェントを appdynamics 名前空間に展開します。

   CODECopy

   helm install -f ./values-ca1.yaml "<my-cluster-agent-helm-release>" appdynamics-cloud-helmcharts/cluster-agent --namespace=appdynamics

   helm install -f ./values-ca1.yaml "<my-cluster-agent-helm-release>" appdynamics-cloud-helmcharts/cluster-agent --namespace=appdynamics