Kubernetes CLI を使用したインフラストラクチャの可視性のインストール

このページでは、クラスタ エージェント オペレータがインストールされている Kubernetes クラスタにマシンエージェントとネットワークエージェントをインストールする方法について説明します。

クラスタ エージェント オペレータは、InfraViz と呼ばれるカスタムリソース定義を提供します。InfraViz を使用すると、Kubernetes クラスタ内の daemonset としてのマシンエージェントとネットワークエージェントの展開を簡素化できます。さらに、クラスタ エージェント オペレータを必要としない daemonset YAML を作成することで、これらのエージェントを展開できます。詳細については、これらの例を参照してください。 

分析エージェントを Kubernetes クラスタ内の daemonset として展開するには、「Kubernetes でのエージェント側コンポーネントのインストール」を参照してください。

要　件

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

• kubectl 1.16 以上がインストールされていること
• クラスタエージェント 21.3.1 以上
• 「クラスタエージェントの要件およびサポート対象環境」の要件を満たしていること
• サーバの可視性が必要な場合は、クラスタ内のワーカーノードの数に基づいて十分なサーバの可視性ライセンスがあること 
• AppDynamics コントローラでサーバを表示する権限

設置手順

1. クラスタエージェントのインストール）。この Alpine Linux の例から次の手順を実行します。

   1. クラスタ エージェント バンドルをダウンロードします。 

   2. クラスタ エージェント バンドルを解凍します。

   3. 適切な Kubernetes および OpenShift バージョンを指定する CLI を使用してクラスタ エージェント オペレータを展開します（該当する場合）。

      unzip appdynamics-cluster-agent-alpine-linux-<version>.zip
      kubectl create namespace appdynamics

      BASH
      kubectl create -f cluster-agent-operator.yaml

      BASH

      kubectl create -f cluster-agent-operator-openshift.yaml

      BASH

      kubectl create -f cluster-agent-operator-openshift-1.15-or-less.yaml

      BASH

2. コントローラに接続するマシン エージェント アクセス キーを使用して、クラスタ エージェント シークレットを作成します。cluster-agent-secret が存在しない場合は、作成する必要があります。「Kubernetes CLI を使用したクラスタエージェントのインストール」を参照してください。

   kubectl -n appdynamics create secret generic cluster-agent-secret --from-literal=controller-key=<access-key>

   BASH

3. コントローラの [License] ページの情報に基づいて、controllerUrl、account、および globalAccount の値を設定するように infraviz.yaml ファイルを更新します。
   サーバの可視性を有効にするには、enableServerViz を true に設定します（infraviz.yaml 設定例に示します）。
   サーバの可視性を有効にしないでマシンエージェントを展開するには、enableServerViz を false に設定します。

   infraviz.yaml Configuration File with Server Visibility Enabled

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: appdynamics-infraviz
     namespace: appdynamics
   ---
   apiVersion: cluster.appdynamics.com/v1alpha1
   kind: InfraViz
   metadata:
     name: appdynamics-infraviz
     namespace: appdynamics
   spec:
     controllerUrl: "https://mycontroller.saas.appdynamics.com"
     image: "docker.io/appdynamics/machine-agent:latest"
     account: "<your-account-name>"
     globalAccount: "<your-global-account-name>"
     enableContainerHostId: true
     enableServerViz: true
     resources:
       limits:
         cpu: 500m
         memory: "1G"
       requests:
         cpu: 200m
         memory: "800M"

   YML

   infraviz.yaml 設定ファイルの例では、クラスタ内のノードごとに 1 つのポッドを実行する daemonset を展開します。各ポッドは、マシンエージェント、またはサーバの可視性エージェントが実行される単一のコンテナを実行します。 

4. ネットワークの可視性エージェントを同じポッド内の 2 番目のコンテナで実行できるようにするには、次の設定ファイルの例に示すように、netVizImage および netVizPort のキーと値を追加します。

   infraviz.yaml Configuration File with Second Container in a Single Pod

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: appdynamics-infraviz
     namespace: appdynamics
   ---
   apiVersion: cluster.appdynamics.com/v1alpha1
   kind: InfraViz
   metadata:
     name: appdynamics-infraviz
     namespace: appdynamics
   spec:
     controllerUrl: "https://mycontroller.saas.appdynamics.com"
     image: "docker.io/appdynamics/machine-agent:latest"
     account: "<your-account-name>"
     enableContainerHostId: true
     enableServerViz: true
     netVizImage: appdynamics/machine-agent-netviz:latest
     netVizPort: 3892
     resources:
       limits:
         cpu: 500m
         memory: "1G"
       requests:
         cpu: 200m
         memory: "800M"

   YML

5. kubectl を使用して infraviz.yaml を展開します。

   

   特権ポッドなど、Kubernetes PodSecurityPolicies が特定のポッド セキュリティ コンテキスト設定をブロックする環境では、infraviz.yaml ファイルを編集する前に infraviz-pod-security-policy.yaml を展開する必要があります。

   特権ポッドなど、OpenShift SecurityContextConstraints が特定のポッド セキュリティ コンテキスト設定をブロックする環境では、infraviz.yaml ファイルを編集する前に infraviz-security-context-constraint-openshift.yaml を展開する必要があります。

   kubectl create -f infraviz.yaml

   BASH

   kubectl create -f infraviz-pod-security-policy.yaml
   kubectl create -f infraviz.yaml

   BASH

   kubectl create -f infraviz-security-context-constraint-openshift.yaml
   kubectl create -f infraviz.yaml

   BASH

6. appdynamics-infraviz ポッドが実行中で、マシンエージェント、サーバの可視性エージェント、およびネットワークエージェントのコンテナの準備が完了していることを確認します。

   kubectl -n appdynamics get pods
   NAME                                    READY   STATUS    RESTARTS   AGE
   appdynamics-infraviz-shkhj                     2/2     Running   0          18s
   

   BASH

7. エージェントがコントローラに登録されていることを確認するには、ログを確認し、エージェントがコントローラ管理 UI の [Agents Dashboard] に表示されることを確認します。コントローラでサーバの可視性が有効になっている場合、ノードは [ Controller] > [Servers] の下に表示されます。

   kubectl -n appdynamics logs appdynamics-infraviz-shkhj -c appd-infra-agent
   ...
   Started AppDynamics Machine Agent Successfully

   BASH

混合オペレーティング システム クラスタ

クラスタ エージェント オペレータは、Linux と Windows の両方のノードにマシンエージェント daemonsets を展開できます。混合オペレーティングシステム（OS）クラスタの展開戦略は、nodeOS プロパティの値によって決まります。このプロパティは、次のいずれかのオプションに設定できます。

• all
• linux
• windows

Linux と Windows の両方の daemonsets が、単一の infraviz.yaml ファイルで設定できる同じプロパティを共有する場合、nodeOS: all を設定します。nodeOS が all または windows に設定されている場合、imageWin プロパティを Windows マシンエージェントイメージに設定する必要があります。

この例では、単一の infraviz.yaml ファイルを使用して、Windows および Linux ノードで実行されるマシンエージェントを設定します。

apiVersion: v1
kind: ServiceAccount
metadata:
  name: appdynamics-infraviz
  namespace: appdynamics
---
apiVersion: cluster.appdynamics.com/v1alpha1
kind: InfraViz
metadata:
  name: appdynamics-infraviz
  namespace: appdynamics
spec:
  controllerUrl: "https://mycontroller.saas.appdynamics.com"
  image: "docker.io/appdynamics/machine-agent:latest"
  account: "<your-account-name>"
  globalAccount: "<your-global-account-name>"
  enableContainerHostId: true
  enableServerViz: true
  netVizImage: appdynamics/machine-agent-netviz:latest
  netVizPort: 3892 
  resources:
    limits:
      cpu: 500m
      memory: "1G"
    requests:
      cpu: 200m
      memory: "800M"
  imageWin: docker.io/appdynamics/machine-agent-analytics:win-latest  
  nodeOS: all

Windows と Linux の daemonsets プロパティが異なり、別々の infraviz.yaml ファイルで定義する必要がある場合、Set nodeOS: windows  または  nodeOS: linux  を設定します。nodeOS の値に応じて、クラスタ エージェント オペレータはマシンエージェントに nodeSelector 値を割り当て、マシンエージェントの配置を決定します。
nodeOS: windows では、"kubernetes.io/os" を windows に設定します。
nodeOS: linux では、kubernetes.io/os を linux に設定します。 

このデフォルトの動作を上書きするには、infraviz.yaml で nodeSelector を指定します。 {{2}}は特定の属性を識別し、 {{3}} はこの属性に割り当てる新規の値を指定します。

apiVersion: v1
kind: ServiceAccount
metadata:
  name: appdynamics-infraviz
  namespace: appdynamics
---
apiVersion: cluster.appdynamics.com/v1alpha1
kind: InfraViz
metadata:
  name: appdynamics-infraviz
  namespace: appdynamics
spec:
  # ... content removed for brevity  
  nodeOS: windows
  imageWin: docker.io/appdynamics/machine-agent-analytics:win-latest  
  nodeSelector:
    kubernetes.io/os: my-windows-node-selector

InfraViz 設定

インフラストラクチャの可視性を設定するには、ダウンロードパッケージに含まれている infraviz.yaml ファイルの次のパラメータを変更します。ファイルを変更したら、InfraViz 展開を削除して再作成し、変更を適用します。