クラスタエージェントのアップグレード

2024 年 7 月 8 日に Liza Sibu によって作成

このページでは、次を使用してクラスタエージェントをアップグレードする方法について説明します。

  • Kubernetes CLI、または
  • クラスタエージェント Helm チャート

設置ワークフロークラスタエージェントをインストールするには：

注: クラスタエージェント 23.2 以降では、最新のバンドルをダウンロードし、パッケージ化された YAML ファイルのみを使用する必要があります。

Upgrade the Cluster Agent Using Kubernetes CLI

  1. Download the target version of the Cluster Agent bundle from the Downloads portal.
  2. Unzip the bundle and change the directory to the unzipped folder.
    CODE 
    unzip appdynamics-cluster-agent-alpine-linux-<version>.zip
cd appdynamics-cluster-agent-alpine-linux-<version>
  3. Update the cluster-agent.yaml to include any previously applied configuration.
  4. (Optional) If you require the Splunk AppDynamics SaaS integration with Splunk Observability Cloud, check the required configurations in the Install Splunk OTel Collector Using Cluster Agent.
  5. Update the image tag to add the version of the downloaded Cluster Agent bundle (for example, 25.2.0):
    CODE 
    apiVersion: cluster.appdynamics.com/v1alpha1
kind: Clusteragent
metadata:
name: k8s-cluster-agent
namespace: appdynamics
spec:
appName: "<app-name>"
controllerUrl: "http://<appdynamics-controller-host>:8080"
account: "<account-name>"
# docker image info
image: "docker.io/appdynamics/cluster-agent:25.2.0"
serviceAccountName: appdynamics-cluster-agent
  6. Delete and re-create the Operator and Cluster Agent.
    CODE 
    kubectl delete -f cluster-agent.yaml
kubectl delete -f cluster-agent-operator.yaml
kubectl create -f cluster-agent-operator.yaml
kubectl create -f cluster-agent.yaml

Helm チャートを使用したクラスタエージェントのアップグレード

最新のクラスタエージェントの Helm チャートは、appdynamics-charts/cluster-agent にあります。

  1. helm get と helm show を使用して、appdynamics-charts/cluster-agent から最新のクラスタエージェント イメージをインストールするためにアップグレードが必要かどうかを判断します。
    CODE 
    # which images are currently installed by my release?
helm get all "<my-cluster-agent-helm-release>" -n appdynamics | grep -E 'agentTag|operatorTag'
agentTag: 21.12.0
operatorTag: 21.12.0
# which images are available to install?
helm show values appdynamics-charts/cluster-agent | grep -E 'agentTag|operatorTag'
agentTag: 21.12.0
operatorTag: 21.12.0
  2. アップグレードを実行するには、以前のインストールと同じ名前空間を使用してクラスタエージェント Helm チャートをアンインストールし、再インストールします。
    1. （オプション）Splunk AppDynamics SaaS と Splunk Observability Cloud との統合が必要な場合は、「クラスタエージェントを使用した Splunk OTel コレクタのインストール」で必要な構成を確認します。
    2. 既存の helm チャートをアンインストールします。
      CODE 
      helm uninstall "<cluster-agent-helm-release>" --namespace appdynamics
    3. 次のコマンドを使用して、Splunk AppDynamics エージェントに関連する、以前にインストールされたすべての CustomResourceDefinition（CRD）を削除します。
      CODE 
      kubectl get crd | grep appdynamics
kubectl delete crd clusteragents.cluster.appdynamics.com
kubectl delete crd infravizs.cluster.appdynamics.com
    4. 同じ名前空間を使用して、クラスタエージェントの helm チャートをインストールします。
      CODE 
      helm install -f ./ca1-values.yaml "<my-cluster-agent-helm-release>" appdynamics-charts/cluster-agent --namespace=appdynamics