Delete a cluster

This page explains how to delete a node pool and a cluster.

Warning: Soon after you delete a Google Cloud project, the resources in AWS are permanently deleted. To safeguard against the accidental deletion of a Google Cloud project, use a Project lien.

Delete a node pool

To delete a cluster, you must first delete all of its node pools.

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. In the cluster list, select the name of the cluster, and then select View details in the side panel.

4. Select the Nodes tab to see a list of all the node pools.

5. Select a node pool from the list.

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

gcloud

1. Get a list of your node pools:

   gcloud container aws node-pools list \
     --cluster CLUSTER_NAME \
     --location GOOGLE_CLOUD_LOCATION
   

   Replace the following:

   • CLUSTER_NAME: the name of the cluster that the node pool is attached to
   • GOOGLE_CLOUD_LOCATION: the Google Cloud location hosting the node pool

2. For each of your node pools, delete it with the following command:

   gcloud container aws node-pools delete NODE_POOL_NAME \
     --cluster CLUSTER_NAME \
     --location GOOGLE_CLOUD_LOCATION
   

   Replace the following:

   • NODE_POOL_NAME: the name of the node pool to delete
   • CLUSTER_NAME
   • GOOGLE_CLOUD_LOCATION

How GKE on AWS protects workloads during node pool deletion

During node pool deletion, GKE on AWS performs graceful shut down on each node without honoring PodDisruptionBudget. It takes the following steps:

1. Disable cluster autoscaler if it was enabled.
2. Set up a deadline for the draining process. After this deadline, even if there are still Pod objects existing, GKE on AWS stops draining and proceeds to deleting underlying virtual machines. The default deadline is 5 minutes. For every 10 more nodes, 5 more minutes is added.
3. Cordon all the nodes in the node pool.
4. Before deadline is met, delete Pod objects in the node pool with best efforts.
5. Delete all the underlying compute resources.

Delete a cluster

Before deleting a cluster, make sure that you have deleted all of its node pools.

Note: To delete a cluster, you must have the GKE Multi-Cloud API role configured to allow the GKE Multi-Cloud API to manage your cluster resources. If this role is not properly configured, GKE Enterprise cannot delete the associated resources.

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. In the cluster list, select the name of the cluster, and then select View details in the side panel.

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

gcloud

To delete a cluster, run the following command:

gcloud container aws clusters delete CLUSTER_NAME \
    --location GOOGLE_CLOUD_LOCATION

Replace the following:

• CLUSTER_NAME: the name of the cluster to delete
• GOOGLE_CLOUD_LOCATION: the Google Cloud location hosting this cluster

What's next

• For more information, see the gcloud container aws clusters delete documentation.