Perform an upgrade

Upgrade a DNS-controller instance

Log in to the appropriate artifact registry with Helm and set the repository address

• Log in to the appropriate artifact registry with Helm and set the repository address.

Upgrade the DNS-controller instance

1. In a terminal window on your computer, make sure you’re in the Aspen Mesh Platform chart directory for the new version (the version you want to upgrade to).

2. Copy the override values file for the old version of the DNS-controller instance (the version you’re upgrading from) to the Aspen Mesh Platform chart directory for the new version (the version you want to upgrade to).

3. Set the AM_TAG environment variable to the old version of the DNS controller (the version you’re upgrading from).

   Example

   $ export AM_TAG=1.21.6-am1
   

4. Copy the old DNS-controller values.yaml file to a temporary file:

   $ helm show values oci://$AM_REPO/charts/dns-controller --version $AM_TAG > dns-controller-values-old.yaml
   

5. Set the AM_TAG environment variable to the new version of the DNS controller (the version you want to upgrade to).

   Example

   $ export AM_TAG=1.21.6-am2
   

6. Copy the new DNS-controller values.yaml file to a temporary file:

   $ helm show values oci://$AM_REPO/charts/dns-controller --version $AM_TAG > dns-controller-values-new.yaml
   

7. Compare the new temporary file with the old temporary file:

   $ diff dns-controller-values-new.yaml dns-controller-values-old.yaml
   

8. If there are any new fields that are required or that you want to override:

   • 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.

9. Delete the temporary files:

   $ rm dns-controller-values-old.yaml dns-controller-values-new.yaml
   

10. Download the Aspen Mesh dns-controller chart archive file:

    $ helm pull oci://$AM_REPO/charts/dns-controller --version $AM_TAG
    

11. Extract the Aspen Mesh dns-controller chart archive file:

    $ tar xvf <chartArchiveFilename>
    

12. Upgrade the DNS-controller custom resource definition (CRD):

    $ kubectl apply -f dns-controller/crds
    

13. Are you upgrading a general DNS-controller instance (not a realm-specific DNS-controller instance)?

    • Yes:

      • Upgrade the DNS-controller instance without specifying a realm:

        $ helm upgrade <dnsControllerInstanceName> oci://$AM_REPO/charts/dns-controller --version $AM_TAG \
            --namespace <instanceNamespaceName> \
            --values <instanceOverrideValuesFilename> \
            --wait
        

    • No:

      • Upgrade the DNS-controller instance and specify its realm:

        $ helm upgrade <dnsControllerInstanceName> oci://$AM_REPO/charts/dns-controller --version $AM_TAG \
            --namespace <instanceNamespaceName> \
            --values <instanceOverrideValuesFilename> \
            --set realm=<realmName> \
            --wait