Perform an upgrade from Aspen Mesh 1.11#

Upgrade an Aspen Mesh 1.11 DNS-controller instance#

Introduction#

Aspen Mesh 1.11 (versions 1.11.8-am3 and 1.11.8-am4) supports only one instance of the DNS controller that manages all of the Aspen Mesh DNS static entries in a cluster. When you upgrade to Aspen Mesh 1.14, that instance becomes a general (as opposed to realm-specific) DNS-controller instance.

If you don’t install any realm-specific DNS-controller instances, the general DNS-controller instance continues managing all the Aspen Mesh DNS static entries in the cluster. If you install one or more realm-specific DNS controllers, the general DNS-controller instance begins managing only the Aspen Mesh DNS static entries that are not in a realm.

When to follow these instructions#

Follow the instructions below if you want to upgrade an Aspen Mesh 1.11 DNS-controller instance. Perform the tasks in order.

Before you upgrade#

  • Annotate the dnsstaticentries.networking.aspenmesh.io custom resource definition to prevent Helm from deleting the existing custom resource definition:

    $ kubectl annotate crd dnsstaticentries.networking.aspenmesh.io helm.sh/resource-policy=keep

Upgrade the DNS-controller instance#

  1. Change to the Aspen Mesh release directory for the new version (the version you want to upgrade to).

  2. Compare the new DNS-controller values.yaml file with the old DNS-controller values.yaml file (for the currently installed version):

    $ diff manifests/charts/dns-controller/values.yaml <oldDnsControllerValuesFilename>

  3. Are there any new fields that are required or that you want to override?

    • Yes:

      • Open the override values file for the DNS-controller instance in a text editor.

      • Copy the fields to the override values file and change their values if you want to override them.

      • Save and close the file.

      • Go to step 4.

    • No:

      • Go to step 4.

  4. Upgrade the DNS-controller custom resource definition:

    $ kubectl apply -f manifests/charts/dns-controller/crds

  5. Upgrade the DNS-controller instance:

    $ helm upgrade dns-controller manifests/charts/dns-controller \
    --namespace <namespaceName> \
    --values <instanceOverrideValuesFilename>

Install realm-specific DNS-controller instances#

When to follow these instructions#

Follow the instructions below only after you upgrade the Aspen Mesh 1.11 DNS-controller instance to an Aspen Mesh 1.14 general DNS-controller instance and only if you want to install one or more realm-specific DNS-controller instances.

Install one or more realm-specific DNS-controller instances#