Chapter 14. Destroying a hosted cluster 14.1. Destroying a hosted cluster on AWS You can destroy a hosted cluster and its managed cluster resource on Amazon Web Services (AWS) by using the command-line interface (CLI). 14.1.1. Destroying a hosted cluster on AWS by using the CLI You can use the command-line interface (CLI) to destroy a hosted cluster on Amazon Web Services (AWS). Procedure Delete the managed cluster resource on multicluster engine Operator by running the following command: USD oc delete managedcluster <hosted_cluster_name> 1 1 Replace <hosted_cluster_name> with the name of your cluster. Delete the hosted cluster and its backend resources by running the following command: USD 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 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: USD aws sts get-session-token --output json > sts-creds.json 14.2. Destroying a hosted cluster on bare metal You can destroy hosted clusters on bare metal by using the command-line interface (CLI) or the multicluster engine Operator web console. 14.2.1. Destroying a hosted cluster on bare metal by using the CLI You can use the hcp command-line interface (CLI) to destroy a hosted cluster on bare metal. Procedure Delete the hosted cluster and its backend resources by running the following command: USD hcp destroy cluster agent --name <hosted_cluster_name> 1 1 Specify the name of your hosted cluster. 14.2.2. Destroying a hosted cluster on bare metal by using the web console You can use the multicluster engine Operator web console to destroy a hosted cluster on bare metal. Procedure In the console, click Infrastructure Clusters . On the Clusters page, select the cluster that you want to destroy. In the Actions menu, select Destroy clusters to remove the cluster. 14.3. Destroying a hosted cluster on OpenShift Virtualization You can destroy a hosted cluster and its managed cluster resource on OpenShift Virtualization by using the command-line interface (CLI). 14.3.1. Destroying a hosted cluster on OpenShift Virtualization by using the CLI You can use the command-line interface (CLI) to destroy a hosted cluster and its managed cluster resource on OpenShift Virtualization. Procedure Delete the managed cluster resource on multicluster engine Operator by running the following command: USD oc delete managedcluster <hosted_cluster_name> Delete the hosted cluster and its backend resources by running the following command: USD hcp destroy cluster kubevirt --name <hosted_cluster_name> 14.4. Destroying a hosted cluster on IBM Z You can destroy a hosted cluster on x86 bare metal with IBM Z compute nodes and its managed cluster resource by using the command-line interface (CLI). 14.4.1. Destroying a hosted cluster on x86 bare metal with IBM Z compute nodes To destroy a hosted cluster and its managed cluster on x86 bare metal with IBM Z compute nodes, you can use the command-line interface (CLI). Procedure Scale the NodePool object to 0 nodes by running the following command: USD oc -n <hosted_cluster_namespace> scale nodepool <nodepool_name> \ --replicas 0 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: USD oc --kubeconfig <hosted_cluster_name>.kubeconfig delete \ node <compute_node_name> Verify the status of the compute nodes by entering the following command: USD oc --kubeconfig <hosted_cluster_name>.kubeconfig get nodes After the compute nodes are detached from the hosted cluster, the status of the agents is changed to auto-assign . Delete the agents from the cluster by running the following command: USD oc -n <hosted_control_plane_namespace> delete agent <agent_name> Note You can delete the virtual machines that you created as agents after you delete the agents from the cluster. Destroy the hosted cluster by running the following command: USD hcp destroy cluster agent --name <hosted_cluster_name> \ --namespace <hosted_cluster_namespace> 14.5. Destroying a hosted cluster on IBM Power You can destroy a hosted cluster on IBM Power by using the command-line interface (CLI). 14.5.1. Destroying a hosted cluster on IBM Power by using the CLI To destroy a hosted cluster on IBM Power, you can use the hcp command-line interface (CLI). Procedure Delete the hosted cluster by running the following command: USD hcp destroy cluster agent --name=<hosted_cluster_name> \ 1 --namespace=<hosted_cluster_namespace> \ 2 --cluster-grace-period <duration> 3 1 Replace <hosted_cluster_name> with the name of your hosted cluster. 2 Replace <hosted_cluster_namespace> with the name of your hosted cluster namespace. 3 Specifies the duration to destroy the hosted cluster completely, for example, 20m0s . 14.6. Destroying a hosted cluster on non-bare-metal agent machines You can destroy hosted clusters on non-bare-metal agent machines by using the command-line interface (CLI) or the multicluster engine Operator web console. 14.6.1. Destroying a hosted cluster on non-bare-metal agent machines You can use the hcp command-line interface (CLI) to destroy a hosted cluster on non-bare-metal agent machines. Procedure Delete the hosted cluster and its backend resources by running the following command: USD hcp destroy cluster agent --name <hosted_cluster_name> 1 1 Replace <hosted_cluster_name> with the name of your hosted cluster. 14.6.2. Destroying a hosted cluster on non-bare-metal agent machines by using the web console You can use the multicluster engine Operator web console to destroy a hosted cluster on non-bare-metal agent machines. Procedure In the console, click Infrastructure Clusters . On the Clusters page, select the cluster that you want to destroy. In the Actions menu, select Destroy clusters to remove the cluster.

Commands:
oc delete managedcluster <hosted_cluster_name> 1
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
aws sts get-session-token --output json > sts-creds.json
hcp destroy cluster agent --name <hosted_cluster_name> 1
oc delete managedcluster <hosted_cluster_name>
hcp destroy cluster kubevirt --name <hosted_cluster_name>
oc -n <hosted_cluster_namespace> scale nodepool <nodepool_name> --replicas 0
oc --kubeconfig <hosted_cluster_name>.kubeconfig delete node <compute_node_name>
oc --kubeconfig <hosted_cluster_name>.kubeconfig get nodes
oc -n <hosted_control_plane_namespace> delete agent <agent_name>
hcp destroy cluster agent --name <hosted_cluster_name> --namespace <hosted_cluster_namespace>
hcp destroy cluster agent --name=<hosted_cluster_name> \ 1 --namespace=<hosted_cluster_namespace> \ 2 --cluster-grace-period <duration> 3
hcp destroy cluster agent --name <hosted_cluster_name> 1