Offboard a Cluster

If you wish to off-board a cluster from TSB, you can do this one of two ways:

• If the cluster is to be deleted, just remove the cluster configuration from the TSB management plane
• If the cluster is to continue to run, remove the cluster configuration and uninstall the control plane software

Remove the Cluster Configuration

Access the TSB user interface and navigate to the Clusters tab.

Locate the cluster you wish to offboard and delete it.

Uninstall the Control Pane Software from the cluster

You can use helm uninstall to uninstall the control plane software.

Before you uninstall

TSB prevents the deletion of critical resources, which must be disabled to allow uninstallation. Disable it by annotating the operator deployment, then restarting it.

kubectl annotate -n istio-system deployment tsb-operator-control-plane --overwrite tsb.tetrate.io/deletion-protection=disabled
kubectl rollout restart -n istio-system deployment tsb-operator-control-plane

Deletion protection can also be disabled by setting this value in each operator's helm values file, then running a helm upgrade.

operator:
  deletionProtection: disabled

Control Plane Uninstallation

helm uninstall cp tetrate-tsb-helm/controlplane --namespace istio-system

Once Helm has removed all the resources associated with the last release of the control plane chart, you will need to manually remove some resources created during the uninstallation process that are untracked by Helm.

kubectl delete serviceaccount tsb-helm-delete-hook --ignore-not-found
kubectl delete clusterrole tsb-helm-delete-hook --ignore-not-found
kubectl delete clusterrolebinding tsb-helm-delete-hook --ignore-not-found
kubectl delete apiservices.apiregistration.k8s.io v1beta1.external.metrics.k8s.io
kubectl delete validatingwebhookconfigurations.admissionregistration.k8s.io xcp-edge-istio-system
kubectl delete mutatingwebhookconfigurations.admissionregistration.k8s.io xcp-edge-istio-system