Getting started with Red Hat OpenShift Service on AWS (ROSA)

Learn how to get started on Red Hat® OpenShift® Service on AWS, including how to use AWS Security Token Service (STS) to deploy a cluster. Once you’ve finished, proceed to part two and learn how to deploy an application on your new cluster.

You can also watch this interactive demonstration on how to install ROSA, from creating an account to deploying applications.

Learn how to get started on Red Hat® OpenShift® Service on AWS, including how to use AWS Security Token Service (STS) to deploy a cluster. Once you’ve finished, proceed to part two and learn how to deploy an application on your new cluster.

You can also watch this interactive demonstration on how to install ROSA, from creating an account to deploying applications.

Deleting a cluster in Red Hat OpenShift Service on AWS

5 mins

To delete a Red Hat® OpenShift® Service on AWS (ROSA) cluster, follow the steps below.

What will you learn?

  • How to delete a cluster

Delete a cluster

  1. If you need to list your clusters in order to make sure you are deleting the correct one run:

    rosa list clusters

  2. Once you know which one to delete run:

    rosa delete cluster --cluster <cluster-name>

  3. You will be prompted to confirm that you want to delete the named cluster. Press “y”, then enter. The cluster will be deleted and all its associated infrastructure. THIS IS NON-RECOVERABLE.

    NOTE: All AWS STS/IAM roles and policies will remain and must be deleted manually once the cluster deletion is complete by following the steps below.

  4. The command will output the next two commands to delete the other resources that were created. You must wait until the cluster has finished deleting (from the previous command). You can use rosa list clusters to do a quick status check.
  5. Once complete, delete the:

    OpenID Connect (OIDC) provider that you created for Operator authentication. Run:

    rosa delete oidc-provider -c <clusterID> --mode auto --yes

    Cluster-specific Operator IAM roles. Run:

    rosa delete operator-roles -c <clusterID> --mode auto --yes

    NOTE: The above steps require you to use the cluster id and not the cluster name.

  6. The remaining roles would be account-scoped and should only be removed if they are no longer needed by other clusters in the same account. (In other words, if you would still like to create other ROSA clusters in this account, do not perform this step.)

    To delete these, you need to know the prefix used when creating them. The default is "ManagedOpenShift" unless you specified otherwise.

    rosa delete account-roles --prefix <prefix> --mode auto --yes

You have now completed all the required steps for deploying and managing your first cluster. In the next resource, we’ll discuss ways you can get support. 

Get more support

Previous resource
Upgrade your cluster in ROSA
Next resource
Deploy an app

This learning path is for operations teams or system administrators

Developers may want to check out developers.redhat.com.

Get started on developers.redhat.com

Hybrid Cloud Logo LinkedIn YouTube Facebook Twitter

Products

Tools

Try, buy, sell

Communicate

About Red Hat

We’re the world’s leading provider of enterprise open source solutions—including Linux, cloud, container, and Kubernetes. We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.