Installation

The Kubernetes Agent has a new component called the Kubernetes monitor that is currently enabled for new installations.

Kubernetes agent install script with the Kubernetes monitor enabled

Once installed, you can confirm the status of the Kubernetes monitor by looking at the Connectivity j page for the corresponding Kubernetes agent target.

Health check showing status of the Kubernetes monitor

Upgrading an existing Kubernetes agent

Coming soon, we are working on a one click upgrade process from within Octopus Deploy.

If you can’t wait until then, you can upgrade existing Kubernetes agents by running a Helm command on your cluster.

Find the following values and replace them in the Helm command below

ValueExample
INSTANCE_URLThe URL you access your instance with, without https:// or a trailing slashmy-instance.octopus.app
API_KEYAn API key for your user, created from your profileAPI-MYKEY
SPACE_IDThe ID of the space your agent is installed in, find this in any Octopus urlSpaces-1
AGENT_NAMEThe name of the Kubernetes agentMy Agent
HELM_RELEASEThe name of the Helm release used to install the Kubernetes agentmyagent
helm upgrade --atomic \
  --namespace "octopus-agent-$AGENT_NAME" \
  --reuse-values \
  --version "2.*.*" \
  --set kubernetesMonitor.enabled="true" \
  --set kubernetesMonitor.registration.serverApiUrl="https://$INSTANCE_URL/" \
  --set kubernetesMonitor.monitor.serverGrpcUrl="grpc://$INSTANCE_URL:8443" \
  --set kubernetesMonitor.registration.serverAccessToken="$API_KEY" \
  --set kubernetesMonitor.registration.spaceId="$SPACE_ID" \
  --set kubernetesMonitor.registration.machineName="$AGENT_NAME" \
  $HELM_RELEASE \
  oci://registry-1.docker.io/octopusdeploy/kubernetes-agent

Uninstalling the Kubernetes monitor

If you need to disable the Kubernetes monitor temporarily, change the replica count to zero on the Kubernetes deployment called $AGENT_NAME-kubernetesmonitor in the Kubernetes Agent namespace.

If you need to permanently uninstall the Kubernetes monitor, then find the following values and replace them in the Helm command below

ValueExample
AGENT_NAMEThe name of the Kubernetes agentMy Agent
HELM_RELEASEThe name of the Helm release used to install the Kubernetes agentmyagent
helm upgrade --atomic \
  --namespace "octopus-agent-$AGENT_NAME" \
  --reuse-values \
  --version "2.*.*" \
  --set kubernetesMonitor.enabled="false" \
  $HELM_RELEASE \
  oci://registry-1.docker.io/octopusdeploy/kubernetes-agent

Help us continuously improve

Please let us know if you have any feedback about this page.

Send feedback

Page updated on Friday, March 28, 2025