Skip to content

Commit 0508c13

Browse files
mburke5678mburke5678
authored
Merge pull request #56360 from laubai/lbailey-osdocs-4822-rosa-setup-changes-2
OSDOCS#4822 Updated ROSA getting started content to reflect current AWS experience
2 parents 191132e + 44c1101 commit 0508c13

File tree

4 files changed

+37
-23
lines changed

4 files changed

+37
-23
lines changed

‎modules/rosa-getting-started-enable-rosa.adoc

Lines changed: 32 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,15 @@
44
// * rosa_getting_started/rosa-getting-started.adoc
55

66
:_content-type: PROCEDURE
7-
[id="rosa-getting-started-enable-rosa_{context}"]
8-
= Enabling ROSA in your AWS account
7+
[id="rosa-getting-started-verifying-rosa-prerequisites_{context}"]
8+
= Verifying ROSA prerequisites
99

1010
Use the steps in this procedure to enable {product-title} (ROSA) in your AWS account.
1111

1212
.Prerequisites
1313

14-
* You created an AWS account.
14+
* You have a Red Hat account.
15+
* You have an AWS account.
1516
+
1617
[NOTE]
1718
====
@@ -22,4 +23,31 @@ Consider using a dedicated AWS account to run production clusters. If you are us
2223

2324
. Sign in to the https://console.aws.amazon.com/rosa/home[AWS Management Console].
2425

25-
. Activate ROSA in your AWS account by navigating to the link:https://console.aws.amazon.com/rosa/home[ROSA service] and selecting *Enable OpenShift*.
26+
. Navigate to the link:https://console.aws.amazon.com/rosa/home[ROSA service].
27+
28+
. Click *Get started*.
29+
+
30+
The *Verify ROSA prerequisites* page opens.
31+
32+
. Under *ROSA enablement*, ensure that a green check mark and `You previously enabled ROSA` are displayed.
33+
+
34+
If not, follow these steps:
35+
36+
.. Select the checkbox beside `I agree to share my contact information with Red Hat`.
37+
.. Click *Enable ROSA*.
38+
+
39+
After a short wait, a green check mark and `You enabled ROSA` message are displayed.
40+
41+
. Under *Service Quotas*, ensure that a green check and `Your quotas meet the requirements for ROSA` are displayed.
42+
+
43+
If you see `Your quotas don't meet the minimum requirements`, take note of the quota type and the minimum listed in the error message. See Amazon's documentation on link:https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html[requesting a quota increase] for guidance. It may take several hours for Amazon to approve your quota request.
44+
45+
. Under *ELB service-linked role*, ensure that a green check mark and `AWSServiceRoleForElasticLoadBalancing already exists` are displayed.
46+
47+
. Click *Continue to Red Hat*.
48+
+
49+
The *Get started with {product-title} (ROSA)* page opens in a new tab. You have already completed Step 1 on this page, and can now continue with Step 2.
50+
51+
[role="_additional-resources"]
52+
.Additional resources
53+
* link:https://docs.aws.amazon.com/ROSA/latest/userguide/troubleshoot-rosa-enablement.html#error-aws-orgs-scp-denies-permissions[Troubleshoot ROSA enablement errors]

‎modules/rosa-getting-started-environment-setup.adoc

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,8 @@
88

99
Before you create a {product-title} (ROSA) cluster, you must set up your environment by completing the following tasks:
1010

11-
* Enable ROSA in your AWS account.
11+
* Verify ROSA prerequisites against your AWS and Red Hat accounts.
1212
* Install and configure the required command line interface (CLI) tools.
1313
* Verify the configuration of the CLI tools.
14-
* Verify that the AWS Elastic Load Balancing (ELB) service role exists.
15-
* Verify that the required AWS resource quotas are available.
1614

1715
You can follow the procedures in this section to complete these setup requirements.

‎rosa_getting_started/rosa-getting-started.adoc

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -29,17 +29,15 @@ You can create a ROSA cluster either with or without the AWS Security Token Serv
2929
include::modules/rosa-getting-started-environment-setup.adoc[leveloffset=+1]
3030
include::modules/rosa-getting-started-enable-rosa.adoc[leveloffset=+2]
3131
include::modules/rosa-getting-started-install-configure-cli-tools.adoc[leveloffset=+2]
32-
include::modules/rosa-getting-started-verify-elb-role.adoc[leveloffset=+2]
33-
include::modules/rosa-getting-started-verify-aws-quota.adoc[leveloffset=+2]
3432

3533
[id="rosa-getting-started-creating-a-cluster"]
3634
== Creating a ROSA cluster with STS
3735

38-
Choose from one of the following methods to deploy a {product-title} (ROSA) cluster that uses the AWS Security Token Service (STS). In both scenarios, you can deploy your cluster by using {cluster-manager-first} or the ROSA CLI (`rosa`):
36+
Choose from one of the following methods to deploy a {product-title} (ROSA) cluster that uses the AWS Security Token Service (STS). In each scenario, you can deploy your cluster by using {cluster-manager-first} or the ROSA CLI (`rosa`):
3937

40-
* *xref:../rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-quickly.adoc#rosa-sts-creating-a-cluster-quickly[Creating a ROSA cluster with STS using the default options]*: You can create a ROSA cluster with STS quickly by using the default options and automatic STS resource creation.
38+
* xref:../rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-quickly.adoc#rosa-sts-creating-a-cluster-quickly[*Creating a ROSA cluster with STS using the default options*]: You can create a ROSA cluster with STS quickly by using the default options and automatic STS resource creation.
4139

42-
* *xref:../rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-with-customizations.adoc#rosa-sts-creating-a-cluster-with-customizations[Creating a ROSA cluster with STS using customizations]*: You can create a ROSA cluster with STS using customizations. You can also choose between the `auto` and `manual` modes when creating the required STS resources.
40+
* xref:../rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-with-customizations.adoc#rosa-sts-creating-a-cluster-with-customizations[*Creating a ROSA cluster with STS using customizations*]: You can create a ROSA cluster with STS using customizations. You can also choose between the `auto` and `manual` modes when creating the required STS resources.
4341

4442
.Additional resources
4543

@@ -85,4 +83,4 @@ include::modules/rosa-getting-started-deleting-a-cluster.adoc[leveloffset=+1]
8583

8684
* For information about setting up accounts and ROSA clusters without using AWS STS, see xref:../rosa_install_access_delete_clusters/rosa_getting_started_iam/rosa-getting-started-workflow.adoc#rosa-understanding-the-deployment-workflow[Understanding the ROSA deployment workflow]
8785

88-
* For documentation on upgrading your cluster, see xref:../upgrading/rosa-upgrading.adoc#rosa-upgrading[Upgrading ROSA clusters]
86+
* For documentation on upgrading your cluster, see xref:../upgrading/rosa-upgrading.adoc#rosa-upgrading[Upgrading ROSA clusters]

‎rosa_getting_started/rosa-quickstart-guide-ui.adoc

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -43,16 +43,6 @@ include::modules/rosa-getting-started-enable-rosa.adoc[leveloffset=+2]
4343
include::modules/rosa-getting-started-install-configure-cli-tools.adoc[leveloffset=+2]
4444

4545

46-
//This content is pulled from rosa-getting-started-verify-elb-role.adoc
47-
[discrete]
48-
include::modules/rosa-getting-started-verify-elb-role.adoc[leveloffset=+2]
49-
50-
51-
//This content is pulled from rosa-getting-started-verify-aws-quota.adoc
52-
[discrete]
53-
include::modules/rosa-getting-started-verify-aws-quota.adoc[leveloffset=+2]
54-
55-
5646
//This content is pulled from rosa-sts-creating-a-cluster-quickly.adoc
5747
[id="rosa-quickstart-creating-a-cluster"]
5848
== Creating a ROSA cluster with AWS STS using the default auto mode

0 commit comments

Comments
 (0)