Chapter 16. Destroying a hosted cluster

Procedure

1. Delete the managed cluster resource on multicluster engine Operator by running the following command:

   $ oc delete managedcluster <hosted_cluster_name> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Replace <hosted_cluster_name> with the name of your cluster.

2. Delete the hosted cluster and its backend resources by running the following command:

   $ hcp destroy cluster aws  \
     --name <hosted_cluster_name> \

   1

   
     --infra-id <infra_id> \

   2

   
     --role-arn <arn_role> \

   3

   
     --sts-creds <path_to_sts_credential_file> \

   4

   
     --base-domain <basedomain> 

   5

   Copy to Clipboard Toggle word wrap

   1

   Specify the name of your hosted cluster, for instance, example.

   2

   Specify the infrastructure name for your hosted cluster.

   3

   Specify the Amazon Resource Name (ARN), for example, arn:aws:iam::820196288204:role/myrole.

   4

   Specify the path to your AWS Security Token Service (STS) credentials file, for example, /home/user/sts-creds/sts-creds.json.

   5

   Specify your base domain, for example, example.com.

   Important

   If your session token for AWS Security Token Service (STS) is expired, retrieve the STS credentials in a JSON file named sts-creds.json by running the following command:

   $ aws sts get-session-token --output json > sts-creds.json

   Copy to Clipboard Toggle word wrap

Procedure

1. In the console, click Infrastructure Clusters.
2. On the Clusters page, select the cluster that you want to destroy.
3. In the Actions menu, select Destroy clusters to remove the cluster.

Procedure

1. Delete the managed cluster resource on multicluster engine Operator by running the following command:

   $ oc delete managedcluster <hosted_cluster_name>

   Copy to Clipboard Toggle word wrap

2. Delete the hosted cluster and its backend resources by running the following command:

   $ hcp destroy cluster kubevirt --name <hosted_cluster_name>

   Copy to Clipboard Toggle word wrap

Procedure

1. Scale the NodePool object to 0 nodes by running the following command:

   $ oc -n <hosted_cluster_namespace> scale nodepool <nodepool_name> \
     --replicas 0

   Copy to Clipboard Toggle word wrap

   After the NodePool object is scaled to 0, the compute nodes are detached from the hosted cluster. In OpenShift Container Platform version 4.17, this function is applicable only for IBM Z with KVM. For z/VM and LPAR, you must delete the compute nodes manually.

   If you want to re-attach compute nodes to the cluster, you can scale up the NodePool object with the number of compute nodes that you want. For z/VM and LPAR to reuse the agents, you must re-create them by using the Discovery image.

   Important

   If the compute nodes are not detached from the hosted cluster or are stuck in the Notready state, delete the compute nodes manually by running the following command:

   $ oc --kubeconfig <hosted_cluster_name>.kubeconfig delete \
     node <compute_node_name>

   Copy to Clipboard Toggle word wrap

   If you are using an OSA network device in Processor Resource/Systems Manager (PR/SM) mode, auto scaling is not supported. You must delete the old agent manually and scale up the node pool because the new agent joins during the scale down process.

2. Verify the status of the compute nodes by entering the following command:

   $ oc --kubeconfig <hosted_cluster_name>.kubeconfig get nodes

   Copy to Clipboard Toggle word wrap

   After the compute nodes are detached from the hosted cluster, the status of the agents is changed to auto-assign.

3. Delete the agents from the cluster by running the following command:

   $ oc -n <hosted_control_plane_namespace> delete agent <agent_name>

   Copy to Clipboard Toggle word wrap
   Note

   You can delete the virtual machines that you created as agents after you delete the agents from the cluster.

4. Destroy the hosted cluster by running the following command:

   $ hcp destroy cluster agent --name <hosted_cluster_name> \
     --namespace <hosted_cluster_namespace>

   Copy to Clipboard Toggle word wrap

Procedure

1. In the console, click Infrastructure Clusters.
2. On the Clusters page, select the cluster that you want to destroy.
3. In the Actions menu, select Destroy clusters to remove the cluster.