Kubernetes CLI を使用したクラスタエージェントのインストール

このページでは、 OpenShift OperatorHub バンドルを使用してクラスタエージェントをインストールする方法について説明します。これは、「Kubernetes CLI を使用したクラスタエージェントのインストール」の代替手段です。

要件

開始する前に、次のことを確認します。

kubectl 1.16 以上がインストールされていること
「クラスタエージェントの要件およびサポート対象環境」に記載されている要件が満たされていること
クラスタエージェントと AppDynamics オペレータイメージ。カスタムのクラスターエージェントイメージを作成するには、「クラスターエージェントコンテナイメージの作成」を、カスタムオペレータイメージを作成するには、「AppDynamics オペレータコンテナイメージ」を参照してください。

要件

開始する前に、次のことを確認します。

kubectl 1.16 以上がインストールされていること
クラスタエージェントの要件およびサポート対象環境

設置手順

最新のインストール手順については、https://github.com/kubernetes-sigs/metrics-server を参照してください。
```
kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml
```
ダウンロードポータルから Kubernetes または OpenShift クラスタエージェントバンドルをダウンロードし、バンドルの内容を現在のディレクトリに解凍します。
```
unzip appdynamics-cluster-agent-alpine-linux-<version>.zip
```
名前空間 appdynamics の作成
```
kubectl create namespace appdynamics
```
適切な Kubernetes および OpenShift バージョンを使用してクラスタエージェントオペレータをインストールします（該当する場合）。
Kubernetes 1.16 以上
```
kubectl create -f cluster-agent-operator.yaml
```
OpenShift と Kubernetes 1.16 以上
```
kubectl create -f cluster-agent-operator-openshift.yaml
```
OpenShift と Kubernetes 1.15 以下
```
kubectl create -f cluster-agent-operator-openshift-1.15-or-less.yaml
```
注: OpenShift クラスタの OpenShift OperatorHub からクラスタエージェントオペレータをインストールすることもできます。
コントローラのアカウントアクセスキーに基づいて、クラスタエージェントがレポートするコントローラアクセスキーのシークレットを作成します。
```
kubectl -n appdynamics create secret generic cluster-agent-secret --from-literal=controller-key=<access-key>
```

この例では、RedHat Registry で事前作成済みのクラスタエージェントイメージを使用することを前提としています。クラスタエージェントコンテナイメージクラスタエージェントの設定クラスタエージェントコンテナイメージの作成

apiVersion: cluster.appdynamics.com/v1alpha1
kind: Clusteragent
metadata:
name: k8s-cluster-agent
namespace: appdynamics
spec:
appName: "dev-cluster"
controllerUrl: "http://mycontroller.com:8080"
account: "my-account"
# docker image info where, <version> is the image tag version that you are installing
image: "docker.io/appdynamics/cluster-agent:<version>"
serviceAccountName: appdynamics-cluster-agent
nsToMonitorRegex: namespace1|namespace2
stdoutLogging: "true"

（オプション）複数のクラスタエージェントで単一のクラスタをモニターする必要がある場合は、ターゲットアロケータを設定します。cluster-agent.yaml ファイルで、クラスタエージェントのレプリカの数を指定してターゲットアロケータを有効にし、オペレータがクラスタエージェントのレプリカを作成できるようにします。「ターゲットアロケータ」を参照してください。
注: ターゲットアロケータが有効になっている場合、自動インストルメンテーションと containerAppCorrelationMethod（Kubernetes 1.25 以降）はサポートされません。spec.instrumentationMethod を "" か "None" に、また spec.containerAppCorrelationMethod を "" か "none" に設定します。

cluster-agent.yaml
```
…
spec:
…
appName: "my-cluster"
nsToMonitorRegex: ".*"
instrumentationMethod: "None"
containerAppCorrelationMethod: "none"
targetAllocator:
enabled: true
clusterAgentReplicas: 3
podConfig:
imagePullPolicy: Always
imagePullSecret: ecr-secret
priorityClassName: high-priority
serviceAccountName: appdynamics-target-allocator
nodeSelector:{}
tolerations:[]
resources:
limits:
cpu: 500m
memory: 500Mi
requests:
cpu: 200m
memory: 200Mi
labels:{}
securityContext:{}
```
クラスタエージェントをインストールします。
```
kubectl create -f cluster-agent.yaml
```

自動インストルメンテーションの検証とトラブルシューティングについては、「」を参照してください。クラスタエージェントのインストールの検証インストールが検証されたら、クラスタ内のアプリケーションにアプリケーションサーバーエージェントをインストールするためのオプションについて「コンテナのインストールオプション」を参照してください。