Uninstall Rancher Turtles

To uninstall Rancher Turtles use the following Helm command:

helm uninstall -n rancher-turtles-system rancher-turtles --cascade foreground --wait

This may take a few minutes to complete.

Remember that, if you use a different name for the installation or a different namespace, you may need to customize the command for your specific configuration.

When installing Rancher Turtles in your Rancher environment, by default, Rancher Turtles enables the Cluster API Operator cleanup. This includes cleaning up Cluster API Operator specific webhooks and deployments that otherwise cause issues with Rancher provisioning.

To simplify uninstalling Rancher Turtles (via Rancher Manager or Helm command), the official Rancher Turtles Helm chart includes a post-delete hook that applies the following changes, making it transparent to the end user:

  • It deletes the mutating-webhook-configuration and validating-webhook-configuration webhooks that are no longer needed.

  • It deletes the CAPI deployments that are no longer needed.

Once uninstalled, Rancher’s embedded-cluster-api feature must be re-enabled:

  1. Create a feature.yaml file, with embedded-cluster-api set to true:

    feature.yaml
    apiVersion: management.cattle.io/v3
kind: Feature
metadata:
  name: embedded-cluster-api
spec:
  value: true

  2. Use kubectl to apply the feature.yaml file to the cluster:

    kubectl apply -f feature.yaml