Detach your CNCF conformant attached cluster

Detaching a cluster means deregistering it from Google Cloud Fleet management and removing the associated software from your cluster. You can detach the cluster with the Google Cloud CLI or the Google Cloud console.

gcloud CLI

To detach a cluster, use the gcloud container attached clusters delete command.

Providing the optional flag --ignore-errors forces the cluster to detach even if some in-cluster resources can't be deleted. Including the optional --allow-missing flag means that the delete request returns a success code even if the cluster can't be found:

gcloud container attached clusters delete CLUSTER_NAME \
  --ignore-errors \
  --allow-missing \
  --location=GOOGLE_CLOUD_REGION

Replace the following:

  • CLUSTER_NAME: the name of your cluster
  • GOOGLE_CLOUD_REGION: the name of the Google Cloud region administering your cluster

For more information, see gcloud container attached clusters delete.

Console

  1. In the Google Cloud console, go to the Google Kubernetes Engine clusters overview page.

    Go to GKE clusters

  2. Select the Google Cloud project that the cluster is in.

  3. Click the name of the cluster you want to detach, and then select View more details in the side panel.

  4. Near the top of the window, click Delete.

  5. When prompted to confirm, enter the name of the cluster and click Confirm.

When you detach a cluster, all Google Cloud resources related to the cluster, such as the fleet membership resources and workload identity pool OIDC providers are deleted. Any GKE Enterprise features installed in your cluster, such as Config Sync and Cloud Service Mesh, are also deleted. The Kubernetes cluster itself isn't deleted.