Perform an upgrade#

Introduction#

The following instructions describe how to perform an upgrade of Citadel.

If you want to perform a clean installation instead, see Perform a clean installation.

Note

If you haven’t already done so, learn about the Aspen Mesh certificate authorities (CAs) and the types of pods they support.

Upgrade Citadel#

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

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

    $ diff manifests/charts/security/values.yaml <oldCitadelValuesFilename>

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

    • Open the override values file for Citadel (for example, citadel-override-values.yaml) 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.

  4. Upgrade Citadel:

    $ helm upgrade citadel manifests/charts/security \
    --namespace istio-system \
    --values <citadelOverrideValuesFilename> \
    --wait