Preparations
Before doing anything actively to the running installation, the config file for the new installation should be prepared.
First, retrieve the values.yaml you’ve used previously, or if you don’t have it, you can get it from the installation by doing this:
helm get all <helm name> > <output filename>.yaml E.g: helm get all uepe > valuesFromSystem.yaml
Where “uepe” is the helm name you’ve chosen for your installation
helm list NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION external-dns uepe 1 2024-05-08 15:27:48.258978207 +0200 CEST deployed external-dns-7.2.0 0.14.1 ingress-nginx uepe 1 2024-05-08 16:18:43.919980224 +0200 CEST deployed ingress-nginx-4.10.0 1.10.0 uepe uepe 3 2024-05-10 14:16:17.724426589 +0200 CEST deployed usage-engine-private-edition-4.0.0 4.0.0
Next retrieve the new version from the repository:
helm fetch <repo name>/usage-engine-private-edition --version <version> --untar
E.g.:
helm fetch digitalroute/usage-engine-private-edition --version 4.0.0 --untar
Next, check the file CHANGELOG.md inside the created folder to find out what may have changed in the new version when it comes to the values-file.
In case you’re uncertain about the format of the file, here are some examples of keys and how to interpret them:
The following values have been removed: * ```mzOperator.clusterWide``` * ```mzOperator.experimental.performPeriodicWorkflowCleanup``` * ```jmx.remote``` * ```platform.debug.jmx```
The above mean that in the values file they are entered as:
mzOperator: clusterWide: experimental: performPeriodicWorkflowCleanup jmx: remote: platform: debug: jmx:
Each part of the key doesn’t necessarily follow immediately after the previous one, but before any other “parent” on the same level. So on in this example from values.yaml:
debug: script: enabled: false log: level: codeserver: info jetty: 'off' others: warn
One example of a key could be “debug.log.level.jetty”.
Make any necessary updates based on changed field you may be using in the values-file you got from the existing installation so it matches the new version.
TODO: What does the user do if we’ve removed something that they use?
When you’re update the values file you can test it using this command:
helm upgrade --install uepe digitalroute/usage-engine-private-edition --version 4.0.0 -n uepe -f fromHelm.yaml --dry-run=server