Merge pull request #46339 from pneedle-rh/osdocs-3022-removing-permission-verifications-for-sts

OSDOCS-3022 - Removing permission verification reference in STS

Author: pneedle-rh

modules/rosa-configure.adoc

@@ -6,7 +6,6 @@
 [id="rosa-configure_{context}"]
 = Configuring the rosa CLI
 
-
 Use the following commands to configure the `rosa` CLI.
 
 [id="rosa-login_{context}"]
@@ -101,14 +100,19 @@ $ rosa logout [arguments]
 [id="rosa-verify-permissions_{context}"]
 == verify permissions
 
-Verify that the AWS permissions required to create a `rosa` cluster are configured correctly.
+Verify that the AWS permissions required to create a ROSA cluster are configured correctly:
 
 .Syntax
 [source,terminal]
 ----
 $ rosa verify permissions [arguments]
 ----
 
+[NOTE]
+====
+This command verifies permissions only for clusters that do not use the AWS Security Token Service (STS).
+====
+
 .Optional arguments inherited from parent commands
 [cols="30,70"]
 |===

modules/rosa-installing.adoc

@@ -5,10 +5,10 @@
 
 
 :_content-type: PROCEDURE
-[id="rosa-installing_{context}"]
-= Installing ROSA
+[id="rosa-installing-and-configuring-the-rosa-cli_{context}"]
+= Installing and configuring the ROSA CLI
 
-Complete the following steps to install ROSA before creating a cluster.
+Install and configure the ROSA CLI (`rosa`). You can also install the OpenShift CLI (`oc`) and verify if the required AWS resource quotas are available by using the ROSA CLI.
 
 .Prerequisites
 
@@ -92,6 +92,11 @@ $ rosa verify permissions
 I: Validating SCP policies...
 I: AWS SCP policies ok
 ----
++
+[NOTE]
+====
+This command verifies permissions only for ROSA clusters that do not use the AWS Security Token Service (STS).
+====
 
 . Log in to your Red Hat account with `rosa`.
 +

modules/rosa-sts-setting-up-environment.adoc

@@ -3,7 +3,7 @@
 
 = Setting up the environment for STS
 
-Complete the following steps to set up your environment before creating your cluster using AWS security token Service (STS).
+Before you create a {product-title} (ROSA) cluster that uses the AWS Security Token Service (STS), complete the following steps to set up your environment.
 
 .Prerequisites
 
@@ -18,7 +18,7 @@ It is recommended to use a dedicated AWS account to run production clusters. If
 +
 If you are using AWS Organizations and you need to have a service control policy (SCP) applied to the AWS account you plan to use, these policies must not be more restrictive than the roles and policies required by the cluster.
 +
-. Enable the ROSA service in the AWS Console.
+. Enable the ROSA service in the AWS Management Console.
 .. Sign in to your link:https://console.aws.amazon.com/rosa/home[AWS account].
 .. To enable ROSA, go to the link:https://console.aws.amazon.com/rosa/[ROSA service] and select *Enable OpenShift*.
 
@@ -49,7 +49,7 @@ The ROSA service evaluates regions in the following priority order:
 $ aws sts get-caller-identity
 ----
 +
-. Install the latest version of `rosa`, the {product-title} command-line interface (CLI).
+. Install the latest version of the ROSA CLI (`rosa`).
 .. Download the link:https://access.redhat.com/products/red-hat-openshift-service-aws/[latest release] of the `rosa` CLI for your operating system.
 .. Optional: Rename the file you downloaded to `rosa` and make the file executable. This documentation uses `rosa` to refer to the executable file.
 +
@@ -138,7 +138,7 @@ To login to your Red Hat account, get an offline access token at https://console
 I: Logged in as '<rh-rosa-user>' on 'https://api.openshift.com'
 ----
 
-. Verify that your AWS account has the necessary quota to deploy an {product-title} cluster.
+. Verify that your AWS account has the necessary quota to deploy a ROSA cluster.
 +
 [source,terminal]
 ----
@@ -157,9 +157,9 @@ I: AWS quota ok
 Sometimes your AWS quota varies by region. If you receive any errors, try a different region.
 ====
 +
-If you need to increase your quota, go to your link:https://aws.amazon.com/console/[AWS console], and request a quota increase for the service that failed.
+If you need to increase your quota, go to the link:https://aws.amazon.com/console/[AWS Management Console] and request a quota increase for the service that failed.
 +
-After both the permissions and quota checks pass, proceed to the next step.
+After the quota check succeeds, proceed to the next step.
 +
 . Prepare your AWS account for cluster deployment:
 +

modules/rosa-troubleshooting-installing.adoc

@@ -36,10 +36,10 @@ $ rosa logs uninstall --cluster=<cluster_name>
 $ rosa logs uninstall --cluster=<cluster_name> --watch
 ----
 
-[id="rosa-faq-verify-SCP_{context}"]
-== Verify your Amazon Web Services (AWS) account permissions
+[id="rosa-faq-verify-permissions-for-clusters-without-sts_{context}"]
+== Verify your AWS account permissions for clusters without STS
 
-Run the following command to verify your AWS account has the correct permissions:
+Run the following command to verify if your AWS account has the correct permissions. This command verifies permissions only for clusters that do not use the AWS Security Token Service (STS):
 
 [source,terminal]
 ----

rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-config-aws-account.adoc

@@ -15,7 +15,7 @@ include::modules/rosa-configuring-aws-account.adoc[leveloffset=+1]
 [id="next-steps_rosa-config-aws-account"]
 == Next steps
 
-* xref:../../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-installing-rosa.adoc#rosa-installing-rosa[Install ROSA]
+* xref:../../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-installing-rosa.adoc#rosa-installing-cli[Installing the ROSA CLI]
 
 [id="additional-resources_rosa-config-aws-account"]
 [role="_additional-resources"]

rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-getting-started-workflow.adoc

@@ -20,7 +20,7 @@ You can follow the workflow stages outlined in this section to set up and access
 . xref:../../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-aws-prereqs.adoc#prerequisites[Perform the AWS prerequisites]. To deploy a ROSA cluster, your AWS account must meet the prerequisite requirements.
 . xref:../../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-required-aws-service-quotas.adoc#rosa-required-aws-service-quotas[Review the required AWS service quotas]. To prepare for your cluster deployment, review the AWS service quotas that are required to run a ROSA cluster.
 . xref:../../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-config-aws-account.adoc#rosa-config-aws-account[Configure your AWS account]. Before you create a ROSA cluster, you must enable ROSA in your AWS account, install and configure the AWS CLI (`aws`) tool, and verify the AWS CLI tool configuration.
-. xref:../../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-installing-rosa.adoc#rosa-installing-rosa[Install the ROSA and OpenShift CLI tools and verify the AWS servce quotas]. Install and configure the ROSA CLI (`aws`) and the OpenShift CLI (`oc`). You can verify if the required AWS resource quotas are available by using the ROSA CLI.
+. xref:../../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-installing-rosa.adoc#rosa-installing-cli[Install the ROSA and OpenShift CLI tools and verify the AWS servce quotas]. Install and configure the ROSA CLI (`rosa`) and the OpenShift CLI (`oc`). You can verify if the required AWS resource quotas are available by using the ROSA CLI.
 . xref:../../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-creating-cluster.adoc#rosa-creating-cluster[Create a ROSA cluster] or xref:../../rosa_install_access_delete_clusters/rosa-aws-privatelink-creating-cluster.adoc#rosa-aws-privatelink-creating-cluster[Create a ROSA cluster using AWS PrivateLink]. Use the ROSA CLI (`rosa`) to create a cluster. You can optionally create a ROSA cluster with AWS PrivateLink.
 . xref:../../rosa_install_access_delete_clusters/rosa-sts-accessing-cluster.adoc#rosa-sts-accessing-cluster[Access a cluster]. You can configure an identity provider and grant cluster administrator privileges to the identity provider users as required. You can also access a newly deployed cluster quickly by configuring a `cluster-admin` user.
 . xref:../../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-deleting-access-cluster.adoc#rosa-deleting-access-cluster[Revoke access to a ROSA cluster for a user]. You can revoke access to a ROSA cluster from a user by using the ROSA CLI or the web console.

rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-installing-rosa.adoc

@@ -1,24 +1,23 @@
 :_content-type: ASSEMBLY
-[id="rosa-installing-rosa"]
+[id="rosa-installing-cli"]
 = Installing the ROSA CLI
 include::_attributes/attributes-openshift-dedicated.adoc[]
-:context: rosa-installing-rosa
+:context: rosa-installing-cli
 
 toc::[]
 
-After you configure your AWS account, install {product-title} (ROSA).
-
+After you configure your AWS account, install and configure the ROSA CLI (`rosa`).
 
 include::snippets/rosa-sts.adoc[]
 
 include::modules/rosa-installing.adoc[leveloffset=+1]
 
-[id="next-steps_rosa-installing-rosa"]
+[id="next-steps_rosa-installing-cli"]
 == Next steps
 
 * xref:../../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-creating-cluster.adoc#rosa-creating-cluster[Create a ROSA cluster] or xref:../../rosa_install_access_delete_clusters/rosa-aws-privatelink-creating-cluster.adoc#rosa-aws-privatelink-creating-cluster[Create an AWS PrivateLink cluster on ROSA].
 
-[id="additional-resources_rosa-installing-rosa"]
+[id="additional-resources_rosa-installing-cli"]
 [role="_additional-resources"]
 == Additional resources