This is a cache of https://docs.openshift.com/rosa/rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-deleting-cluster.html. It is a snapshot of the page at 2024-09-21T03:04:06.702+0000.
Deleting a ROSA cluster - Deploying ROSA without AWS STS | Install ROSA Classic clusters | Red Hat OpenShift <strong>service</strong> on AWS
×

Delete a Red Hat OpenShift service on AWS (ROSA) cluster using the rosa command-line.

AWS Security Token service (STS) is the recommended credential mode for installing and interacting with clusters on Red Hat OpenShift service on AWS (ROSA) because it provides enhanced security.

Prerequisites

  • If Red Hat OpenShift service on AWS 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 Red Hat OpenShift service on AWS (ROSA) cluster using the ROSA CLI (rosa).

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
  1. 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
  2. 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.