Upgrade and Uninstall Helm Chart Deployments
Deployments of Illumio Core for Kubernetes 3.0.0 or later are performed with Helm Charts. Upgrades and uninstallations are also performed with Helm commands.
Upgrade Helm Chart Deployments
To upgrade an existing installation to a newer version after it had been initially deployed with a Helm Chart, follow standard Helm practice with the helm upgrade command.
For example, if you install the Helm Chart for Core for Kubernetes 4.2.0 initially with this command:
helm install illumio -f values.yaml oci://quay.io/illumio/illumio --version 4.2.0 --namespace illumio-system
Then use the following command to upgrade to version 4.3.0:
helm upgrade illumio -f values.yaml oci://quay.io/illumio/illumio --version 4.3.0
Use the same values.yaml file for the upgrade that was used for the original install command.
Important
Be sure to explicitly specify the version to upgrade to with the --version <ver#> option (for example, --version 4.3.0), after confirming that the product version you want to install is supported with your PCE version. Verify which PCE versions support the Illumio Core for Kubernetes version you want to deploy at the Kubernetes Operator OS Support and Dependencies page on the Illumio Support Portal.
Uninstall Helm Chart Deployments
Uninstalling Helm Chart deployments differs based on the Helm Chart version.
Versions 5.4.0 and higher
clusterMode unpair C-VENs from PCE before Helm Chart uninstallation
For Helm Chart version 5.4.0 and higher, you can change the cluster mode to unpair with clusterMode:unpair within the values.yaml file and perform helm upgrade or ArgoCD sync or the equivalent.
Once the unpair completes, check the Workloads tab within Illumio to verify that all of the cluster node workloads were removed.
Versions lower than 5.4.0
To completely uninstall an existing installation that had been initially deployed with a Helm Chart:
$ helm uninstall illumio --namespace illumio-system $ kubectl delete namespace illumio-system
The uninstallation process also unpairs the C-VENs from the PCE.
Uninstalling the Helm Chart takes around two minutes to complete.