Skip to content

Latest commit

 

History

History
82 lines (59 loc) · 4.72 KB

cs_remove.md

File metadata and controls

82 lines (59 loc) · 4.72 KB
Raw
copyright lastupdated keywords subcollection
years
2014, 2019
2019-09-27
kubernetes, iks, clusters, worker nodes, worker pools, delete
containers

{:new_window: target="_blank"} {:shortdesc: .shortdesc} {:screen: .screen} {:pre: .pre} {:table: .aria-labeledby="caption"} {:codeblock: .codeblock} {:tip: .tip} {:note: .note} {:important: .important} {:deprecated: .deprecated} {:download: .download} {:preview: .preview} {:gif: data-image-type='gif'}

Removing clusters

{: #remove}

Clusters that are created with a billable account must be removed manually when they are not needed anymore so that those clusters are no longer consuming resources. {:shortdesc}

No backups are created of your cluster or your data in your persistent storage. When you delete a cluster, you can choose to delete your persistent storage. Persistent storage that you provisioned by using a `delete` storage class is permanently deleted in IBM Cloud infrastructure if you choose to delete your persistent storage. If you provisioned your persistent storage by using a `retain` storage class and you choose to delete your storage, the cluster, the PV, and PVC are deleted, but the persistent storage instance in your IBM Cloud infrastructure account remains.

When you remove a cluster, you also remove any subnets that were automatically provisioned when you created the cluster and that you created by using the `ibmcloud ks cluster subnet create` command. However, if you manually added existing subnets to your cluster by using the `ibmcloud ks cluster subnet add` command, these subnets are not removed from your IBM Cloud infrastructure account and you can reuse them in other clusters.

Before you begin:

To remove a cluster:

  1. Optional: From the CLI, save a copy of all data in your cluster to a local YAML file.
kubectl get all --all-namespaces -o yaml

{: pre}

  1. Remove the cluster.

  • From the {{site.data.keyword.cloud_notm}} console

    1. Select your cluster and click Delete from the More actions... menu.

  • From the {{site.data.keyword.cloud_notm}} CLI

    1. List the available clusters.

      ibmcloud ks cluster ls

      {: pre}

    2. Delete the cluster.

      ibmcloud ks cluster rm --cluster <cluster_name_or_ID>

      {: pre}

    3. Follow the prompts and choose whether to delete cluster resources, which include containers, pods, bound services, persistent storage, and secrets.

      • Persistent storage: If you dynamically provisioned storage with a storage class that sets reclaimPolicy: Delete, your persistent volume claim (PVC), persistent volume (PV), and the storage instance are automatically deleted when you delete the cluster. However, depending on when you delete the cluster, you might still see your storage instance in the {{site.data.keyword.cloud_notm}} console for up to 72 hours or until the new billing cycle begins. VPC Block Storage is not removed automatically, even if you used a Delete storage class.

        For storage that was statically provisioned, VPC Block Storage, or storage that you provisioned with a storage class that sets reclaimPolicy: Retain, the PVC and the PV are removed when you delete the cluster, but your storage instance and your data remain. You are still charged for your storage instance.

        To manually remove the storage and find frequently asked questions about storage removal, see Removing persistent storage from a cluster.

Next steps:

  • After it is no longer listed in the available clusters list when you run the ibmcloud ks cluster ls command, you can reuse the name of a removed cluster.
  • If you kept the subnets, you can reuse them in a new cluster or manually delete them later from your IBM Cloud infrastructure portfolio.
  • If you kept the persistent storage, you can delete your storage later through the IBM Cloud infrastructure dashboard in the {{site.data.keyword.cloud_notm}} console.