Uninstall Palette

To uninstall Palette from your cluster, you need to uninstall Palette management plane and Cert Manager. Optionally, you may have installed Image Swap and Reach system, which also need to be uninstalled. This uninstall process applies to both connected and airgap instances of self-hosted Palette.

warning

This uninstallation process only applies to Palette instances installed using Helm charts. If you used the Palette CLI to install Palette, this process does not apply.

Prerequisite

• An active self-hosted Palette instance.

• Access to the Kubernetes cluster where Palette is deployed.

• Permissions to perform delete actions on all relevant cluster resources.

• Helm is installed and available on your host machine.

• kubectl is installed and available on your host machine.

Uninstall Palette

1. Ensure you are using the appropriate context where Palette is deployed.

   kubectl config current-context

2. Issue the following command to start uninstalling the Palette management plane. This will only remove the resources managed by Helm and the remaining resources will require additional manual intervention.

   helm uninstall hubble

3. Issue the following command to remove the namespace and custom resource definitions related to the Palette management plane.

   kubectl delete namespace hubble-system || kubectl delete crd spectroclusteractions.jet.cluster.spectrocloud.com

4. Issue the following command to uninstall Cert Manager. Cert Manager does not reply on any Helm hooks and the Helm uninstall command will uninstall all related resources.

   helm uninstall cert-manager

5. (Optional) If you installed Reach, issue the following command to start uninstalling Reach. This will remove all resources related to Reach that are managed by Helm. However, some resources created by Helm hooks are not managed by Helm and will require additional manual intervention to remove.

   helm uninstall reach-system

6. (Optional) Issue the following commands to remove the remaining Reach system resources.

   kubectl delete ns reach-system
   kubectl delete crd podpresets.reach.spectrocloud.com clusterpodpresets.reach.spectrocloud.com
   kubectl delete mutatingwebhookconfiguration reach-mutating-webhook-configuration
   kubectl delete validatingwebhookconfiguration reach-validating-webhook-configuration
   kubectl delete clusterrolebinding reach-manager-rolebinding
   kubectl delete clusterrolebinding reach-proxy-rolebinding
   kubectl delete clusterrole reach-manager-role
   kubectl delete clusterrole reach-metrics-reader
   kubectl delete clusterrole reach-proxy-role

7. (Optional) If you installed Image Swap, issue the following command to remove the image-swap chart.

   helm uninstall image-swap

8. (Optional) Issue the following commands to remove the remaining resources related to image-swap.

   kubectl delete ns imageswap-system
   kubectl delete mutatingwebhookconfiguration imageswap-webhook
   kubectl delete csr imageswap.imageswap-system.cert-request

Validate

1. Connect to your cluster via kubectl.

2. Issue the following command to get a list of the remaining namespaces. Confirm that all Palette-related namespaces have been deleted.

   kubectl get namespaces

3. Issue the following command to confirm that all charts have been uninstalled.

   helm ls

4. Issue the following command to retrieve all resources in your cluster across all namespaces. Confirm that no Palette-related resources are remaining.

   kubectl get all --all-namespaces