Deleting a ROSA cluster

Delete a OpenShift Container Platform (ROSA) cluster using the rosa command-line.

Tip

AWS Security Token Service (STS) is the recommended credential mode for installing and interacting with clusters on OpenShift Container Platform because it provides enhanced security.

Prerequisites

If OpenShift Container Platform created a VPC, you must remove the following items from your cluster before you can successfully delete your cluster:
- Network configurations, such as VPN configurations and VPC peering connections
- Any additional services that were added to the VPC

If these configurations and services remain, the cluster does not delete properly.

Deleting a ROSA cluster

You can delete a OpenShift Container Platform (ROSA) cluster using the ROSA CLI (rosa).

Important

If the cluster that created the VPC during the installation is deleted, the associated installation program-created VPC will also be deleted, resulting in the failure of all the clusters that are using the same VPC. Additionally, any resources created with the same tagSet key-value pair of the resources created by the installation program and labeled with a value of owned will also be deleted.

Prerequisites

You have installed a ROSA cluster.
You have installed and configured the latest ROSA CLI (rosa) on your installation host.

Procedure

Enter the following command to delete a cluster and watch the logs, replacing <cluster_name> with the name or ID of your cluster:
```
$ rosa delete cluster --cluster=<cluster_name> --watch
```
To clean up your CloudFormation stack, enter the following command:
```
$ rosa init --delete
```

Troubleshooting

If the cluster cannot be deleted because of missing IAM roles, see Additional Repairing a cluster that cannot be deleted.
If the cluster cannot be deleted for other reasons:
- Check that there are no Add-ons for your cluster pending in the Hybrid Cloud Console.
- Check that all AWS resources and dependencies have been deleted in the Amazon Web Console.