OSDOCS-8384

_topic_maps/_topic_map_rosa.yml

@@ -153,6 +153,8 @@ Topics:
     File: cloud-experts-getting-started-autoscaling
   - Name: Upgrading your cluster
     File: cloud-experts-getting-started-upgrading
+  - Name: Deleting your cluster
+    File: cloud-experts-getting-started-deleting
 - Name: Deploying an application
   Dir: cloud-experts-deploying-application
   Distros: openshift-rosa

cloud_experts_tutorials/cloud-experts-getting-started/cloud-experts-getting-started-deleting.adoc

@@ -0,0 +1,91 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="cloud-experts-getting-started-deleting"]
+= Tutorial: Deleting your cluster
+include::_attributes/attributes-openshift-dedicated.adoc[]
+:context: cloud-experts-getting-started-deleting
+
+toc::[]
+
+//rosaworkshop.io content metadata
+//Brought into ROSA product docs 2024-01-11
+
+You can delete your {product-title} (ROSA) cluster using either the command line interface (CLI) or the user interface (UI). 
+
+== Deleting a ROSA cluster using the CLI
+
+. *Optional:* List your clusters to make sure you are deleting the correct one by running the following command:
++
+[source,terminal]
+----
+$ rosa list clusters
+----
+
+. Delete a cluster by running the following command:
++
+[source,terminal]
+----
+$ rosa delete cluster --cluster <cluster-name>
+----
++
+[WARNING]
+====
+This command is non-recoverable.
+====
+
+. The CLI prompts you to confirm that you want to delete the cluster. Press *y* and then *Enter*. The cluster and all its associated infrastructure will be deleted.
++
+[NOTE]
+====
+All AWS STS and IAM roles and policies will remain and must be deleted manually once the cluster deletion is complete by following the steps below.
+====
+
+. The CLI outputs the commands to delete the OpenID Connect (OIDC) provider and Operator IAM roles resources that were created. Wait until the cluster finishes deleting before deleting these resources. Perform a quick status check by running the following command:
++
+[source,terminal]
+----
+$ rosa list clusters
+----
+
+. Once the cluster is deleted, delete the OIDC provider by running the following command:
++
+[source,terminal]
+----
+$ rosa delete oidc-provider -c <clusterID> --mode auto --yes
+----
+
+. Delete the Operator IAM roles by running the following command:
++
+[source,terminal]
+----
+$ rosa delete operator-roles -c <clusterID> --mode auto --yes
+----
++
+[NOTE]
+====
+This command requires the cluster ID and not the cluster name.
+====
+
+. Only remove the remaining account roles if they are no longer needed by other clusters in the same account. If you want to create other ROSA clusters in this account, do not perform this step.
++
+To delete the account roles, you need to know the prefix used when creating them. The default is "ManagedOpenShift" unless you specified otherwise.
++
+Delete the account roles by running the following command:
++
+[source,terminal]
+----
+$ rosa delete account-roles --prefix <prefix> --mode auto --yes
+----
+
+== Deleting a ROSA cluster using the UI
+
+. Log in to the Red Hat OpenShift Cluster Manager, and locate the cluster you want to delete.
+
+. Click the three dots to the right of the cluster.
++
+image::cloud-experts-getting-started-deleting1.png[]
+
+. In the dropdown menu, click *Delete cluster*.
++
+image::cloud-experts-getting-started-deleting2.png[]
+
+. Enter the name of the cluster to confirm deletion, and click *Delete*.