Update the Kubernetes release agent

Language Icon 1 month ago · 2 min read
Cloud
Contribute Go to Code

Follow the steps on this page to update the CircleCI release agent installed in your Kubernetes cluster.

Refer to the CircleCI Change log to find out about new release agent versioning, updates, and fixes.

Prerequisites

To update the Kubernetes release agent you need an operational CircleCI environment integrated with your Kubernetes cluster. Refer to the following pages for steps:

If you were using the release agent prior to version 1.2.0 you were using app and version in place of circleci.com/component-name and circleci.com/version. While app and version are still supported, we recommend to migrate to the new labels as soon as possible.

Support for the old labels will be dropped in one of the next releases.

After migrating to the new labels, rolling back to versions that used the old labels will be supported only for deployments and Rollouts managed through Helm.

Update steps

  1. Update your local Helm cache:

    helm repo update
  2. Upgrade to the new version:

    helm upgrade --install circleci-release-agent-system release-agent/circleci-release-agent \
    --set tokenSecret.token=[YOUR_CCI_INTEGRATION_TOKEN] --create-namespace \
    --namespace circleci-release-agent-system \
    --set managedNamespaces="{namespace1,namespace2}"