This page describes how to upgrade the Cluster Agent using:

  • Kubernetes CLI, or 
  • Cluster Agent Helm Chart

See Install the Cluster Agent.

Upgrade the Cluster Agent Using Kubernetes CLI

  1. Download the target version of the Cluster Agent bundle from the AppDynamics Downloads portal.
  2. Unzip the bundle and cd to the unzipped folder:

    unzip appdynamics-cluster-agent-alpine-linux-<version>.zip
    cd appdynamics-cluster-agent-alpine-linux-<version>
    BASH
  3. Update the cluster-agent.yaml to include any previously applied configuration.

  4. Update the image tag to add the version of the downloaded Cluster Agent bundle (for example, 21.12.0):

    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:21.12.0"
      serviceAccountName: appdynamics-cluster-agent
    YML
  5. Delete and re-create the Operator and Cluster Agent.

    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
    CODE

Upgrade the Cluster Agent Using the Helm Chart

The latest Cluster Agent Helm Chart is available at appdynamics-charts/cluster-agent. Before you can upgrade to the latest Cluster Agent, you must first uninstall the existing Helm Chart and then re-install it. 

  1. Use helm get and helm show to determine if an upgrade is required to install the most recent Cluster Agent images from appdynamics-charts/cluster-agent:

    # 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
    BASH
  2. To perform the upgrade, uninstall and re-install the Cluster Agent Helm Chart using the same namespace from the previous installation:

    helm uninstall "<my-cluster-agent-helm-release>" --namespace appdynamics
    helm install -f ./ca1-values.yaml "<my-cluster-agent-helm-release>" appdynamics-charts/cluster-agent --namespace=appdynamics
    BASH