Nubus for Kubernetes - Operation Manual 1.x

Upgrade

5. Upgrade#

This section describes how to upgrade Nubus for Kubernetes from one version to another. For the explicit versions, refer to the release notes of the Nubus for Kubernetes version that you want to upgrade to.

Univention tests upgrades to work when upgrading from one minor version to the next one. Skipping minor versions may work in some cases, but Univention doesn’t test skipping and there is no guarantee that it will work. The changelog in the release notes highlights necessary migration activities that you must not skip when upgrading to or over a particular minor version.

In general, Nubus supports upgrades only. Nubus doesn’t support downgrades to previous versions.

Recommendation

Make a backup before starting the upgrade process. Try the upgrade process first in a test environment, before upgrading your production environment.

Follow these steps to upgrade Nubus for Kubernetes:

  1. Read the release notes for the Nubus for Kubernetes version that you want to upgrade to. You find the release notes at Nubus for Kubernetes - Release Notes.

  2. If applicable, read and follow the instructions given in the changelog regarding necessary migration steps. Typically, you must follow those steps before upgrading with helm.

  3. Set the proper environment variables before the upgrade. See Listing 3.3.

  4. Use helm with the command in Listing 5.1 to upgrade Nubus.

    Listing 5.1 Use helm to upgrade Nubus for Kubernetes#
    $ helm upgrade \
   --namespace="$NAMESPACE_FOR_NUBUS" \
   --values custom_values.yaml \
   --version "$VERSION" \
   --timeout 10m \
   "$RELEASE_NAME" \
   oci://artifacts.software-univention.de/nubus/charts/nubus