Merge pull request #64339 from EricPonvelle/OSDOCS-7663_Terraform-QSG

OSDOCS-7663: Added a new Quick Start Guide that uses Terraform

Author: stevsmit

_topic_maps/_topic_map_rosa.yml

@@ -203,6 +203,8 @@ Distros: openshift-rosa
 Topics:
 - Name: Creating a ROSA cluster with STS using the default options
   File: rosa-sts-creating-a-cluster-quickly
+- Name: Creating a ROSA cluster with STS using the default options with Terraform
+  File: rosa-sts-creating-a-cluster-quickly-terraform
 - Name: Creating a ROSA cluster with STS using customizations
   File: rosa-sts-creating-a-cluster-with-customizations
 - Name: Interactive cluster creation mode reference

modules/rosa-sts-account-roles-terraform.adoc

@@ -31,7 +31,6 @@ $ rosa list account-roles
 ----
 +
 
-
 . In your terminal, run the following command to export link:https://console.redhat.com/openshift/token[your {cluster-manager-first} token]. This value must include the full {cluster-manager} token:
 +
 [source,terminal]
@@ -244,4 +243,4 @@ $ terraform destroy
 ----
 ifeval::["{context}" == "rosa-understanding-terraform"]
 :!tf-full:
-endif::[]
+endif::[]

modules/rosa-sts-cluster-terraform-destroy.adoc

@@ -0,0 +1,109 @@
+// Module included in the following assemblies:
+//
+// * rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-quickly-terraform.adoc
+//
+ifeval::["{context}" == "rosa-sts-creating-a-cluster-quickly-terraform"]
+:tf-defaults:
+endif::[]
+:_content-type: PROCEDURE
+
+[id="sd-terraform-cluster-destroy_{context}"]
+= Deleting your ROSA cluster with Terraform
+
+Use the `terraform destroy` command to remove all of the resources that were created with the `terraform apply` command.
+
+[NOTE]
+====
+Do not modify your Terraform `.tf` files
+ifndef::tf-defaults[]
+or the `terraform.tfvars` file
+endif::tf-defaults[]
+before destroying your resources. These variables are matched to resources to delete.
+====
+
+.Procedure
+. In the directory where you ran the `terraform apply` command to create your cluster, run the following command to delete the cluster:
++
+[source,terminal]
+----
+$ terraform destroy
+----
+ifndef::tf-defaults[]
++
+[IMPORTANT]
+====
+After you enter the name of the ROSA cluster and confirm destruction by entering `yes`, you cannot stop the `terraform destroy` process. Your account, Operator roles, and cluster are deleted.
+====
+
+. Enter the name of the cluster that you want to delete:
++
+[source,terminal]
+----
+var.cluster_name
+  Provide the name of your ROSA cluster.
+
+  Enter a value: <name_of_rosa_cluster> <1>
+----
+--
+<1> A valid value is the name of the ROSA cluster you want to delete.
+--
+endif::tf-defaults[]
+
+. Enter `yes` to start the role and cluster deletion:
++
+.Example output of Terraform confirmation:
+[source,terminal]
+----
+Plan: 0 to add, 0 to change, 39 to destroy.
+
+Do you really want to destroy all resources?
+  Terraform will destroy all your managed infrastructure, as shown above.
+  There is no undo. Only 'yes' will be accepted to confirm.
+
+  Enter a value: yes
+----
+
+.Verification
+. Verify that your cluster was destroyed by running the following command:
++
+[source,terminal]
+----
+$ rosa list clusters
+----
++
+.Example output showing no cluster
+[source,terminal]
+----
+I: No clusters available
+----
+
+. Verify that the account roles were destroyed by running the following command:
++
+[source,terminal]
+----
+$ rosa list account-roles
+----
++
+.Example output showing no Terraform-created account roles:
+[source,terminal]
+----
+I: Fetching account roles
+I: No account roles available
+----
+
+. Verify that the Operator roles were destroyed by running the following command:
++
+[source,terminal]
+----
+$ rosa list operator-roles
+----
++
+.Example output showing no Terraform-created Operator roles:
+[source,terminal]
+----
+I: Fetching operator roles
+I: No operator roles available
+----
+ifeval::["{context}" == "rosa-sts-creating-a-cluster-quickly-terraform"]
+:!tf-defaults:
+endif::[]