|
| 1 | +:_content-type: ASSEMBLY |
| 2 | +[id="rosa-quickstart-guide-ui"] |
| 3 | += {product-title} quickstart guide |
| 4 | +include::_attributes/attributes-openshift-dedicated.adoc[] |
| 5 | +:context: rosa-quickstart-guide-ui |
| 6 | + |
| 7 | +toc::[] |
| 8 | + |
| 9 | +[NOTE] |
| 10 | +==== |
| 11 | +If you are looking for a comprehensive getting started guide for ROSA, see xref:../rosa_getting_started/rosa-getting-started.adoc#rosa-getting-started[Comprehensive guide to getting started with {product-title}]. |
| 12 | +==== |
| 13 | + |
| 14 | +Follow this guide to quickly create a {product-title} (ROSA) cluster using the {cluster-manager-first} {hybrid-console-second}, grant user access, deploy your first application, and learn how to revoke user access and delete your cluster. |
| 15 | + |
| 16 | +The procedures in this document enable you to create a cluster that uses AWS Security Token Service (STS). For more information about using AWS STS with ROSA clusters, see xref:../rosa_architecture/rosa-understanding.adoc#rosa-understanding-aws-sts_rosa-understanding[Using the AWS Security Token Service]. |
| 17 | + |
| 18 | +image::291_OpenShift_on_AWS_Intro_1122_docs.png[{product-title}] |
| 19 | + |
| 20 | +[id="rosa-getting-started-prerequisites_{context}"] |
| 21 | +== Prerequisites |
| 22 | + |
| 23 | +* You reviewed the xref:../rosa_architecture/rosa-understanding.adoc#rosa-understanding[introduction to {product-title} (ROSA)], and the documentation on ROSA xref:../rosa_architecture/rosa_architecture_sub/rosa-architecture-models.adoc#rosa-architecture-models[architecture models] and xref:../rosa_architecture/rosa_architecture_sub/rosa-basic-architecture-concepts.adoc#rosa-basic-architecture-concepts[architecture concepts]. |
| 24 | + |
| 25 | +* You have read the documentation on xref:../rosa_planning/rosa-limits-scalability.adoc#rosa-limits-scalability[limits and scalability] and the xref:../rosa_planning/rosa-planning-environment.adoc#rosa-planning-environment[guidelines for planning your environment]. |
| 26 | + |
| 27 | +* You have reviewed the detailed xref:../rosa_planning/rosa-sts-aws-prereqs.adoc#rosa-sts-aws-prereqs[AWS prerequisites for ROSA with STS]. |
| 28 | + |
| 29 | +* You have the xref:../rosa_planning/rosa-sts-required-aws-service-quotas.adoc#rosa-sts-required-aws-service-quotas[AWS service quotas that are required to run a ROSA cluster]. |
| 30 | + |
| 31 | + |
| 32 | +//This content is pulled from rosa-getting-started-environment-setup.adoc |
| 33 | +include::modules/rosa-getting-started-environment-setup.adoc[leveloffset=+1] |
| 34 | + |
| 35 | + |
| 36 | +//This content is pulled from rosa-getting-started-enable-rosa.adoc |
| 37 | +[discrete] |
| 38 | +include::modules/rosa-getting-started-enable-rosa.adoc[leveloffset=+2] |
| 39 | + |
| 40 | + |
| 41 | +//This content is pulled from rosa-getting-started-install-configure-cli-tools |
| 42 | +[discrete] |
| 43 | +include::modules/rosa-getting-started-install-configure-cli-tools.adoc[leveloffset=+2] |
| 44 | + |
| 45 | + |
| 46 | +//This content is pulled from rosa-sts-creating-a-cluster-quickly.adoc |
| 47 | +[id="rosa-quickstart-creating-a-cluster"] |
| 48 | +== Creating a ROSA cluster with AWS STS using the default auto mode |
| 49 | + |
| 50 | +The procedures in this document use the `auto` modes in the {cluster-manager} {hybrid-console-second} to immediately create the required Identity and Access Management (IAM) resources using the current AWS account. The required resources include the account-wide IAM roles and policies, cluster-specific Operator roles and policies, and OpenID Connect (OIDC) identity provider. |
| 51 | + |
| 52 | +//This content is pulled from rosa-sts-creating-a-cluster-quickly-ocm.adoc |
| 53 | +When using the {cluster-manager} {hybrid-console-second} to create a {product-title} (ROSA) cluster that uses the STS, you can select the default options to create the cluster quickly. |
| 54 | + |
| 55 | +Before you can use the {cluster-manager} {hybrid-console-second} to deploy ROSA with STS clusters, you must associate your AWS account with your Red Hat organization and create the required account-wide STS roles and policies. |
| 56 | + |
| 57 | + |
| 58 | +//This content is pulled from rosa-sts-overview-of-the-default-cluster-specifications.adoc |
| 59 | +[discrete] |
| 60 | +include::modules/rosa-sts-overview-of-the-default-cluster-specifications.adoc[leveloffset=+2] |
| 61 | + |
| 62 | + |
| 63 | +//This content is pulled from rosa-sts-understanding-aws-account-association.adoc |
| 64 | +[discrete] |
| 65 | +include::modules/rosa-sts-understanding-aws-account-association.adoc[leveloffset=+2] |
| 66 | + |
| 67 | + |
| 68 | +//This content is pulled from rosa-sts-associating-your-aws-account.adoc |
| 69 | +[discrete] |
| 70 | +include::modules/rosa-sts-associating-your-aws-account.adoc[leveloffset=+2] |
| 71 | + |
| 72 | + |
| 73 | +//This content is pulled from rosa-sts-creating-account-wide-sts-roles-and-policies.adoc |
| 74 | +[discrete] |
| 75 | +include::modules/rosa-sts-creating-account-wide-sts-roles-and-policies.adoc[leveloffset=+2] |
| 76 | + |
| 77 | + |
| 78 | +//This content is pulled from rosa-sts-creating-a-cluster-using-defaults-ocm.adoc |
| 79 | +[discrete] |
| 80 | +include::modules/rosa-sts-creating-a-cluster-using-defaults-ocm.adoc[leveloffset=+2] |
| 81 | + |
| 82 | +//// |
| 83 | +.Additional resources |
| 84 | +
|
| 85 | +* For information about the account-wide IAM roles and policies that are required for ROSA deployments that use STS, see xref:../rosa_architecture/rosa-sts-about-iam-resources.adoc#rosa-sts-account-wide-roles-and-policies_rosa-sts-about-iam-resources[Account-wide IAM role and policy reference]. |
| 86 | +* For details about using the `auto` and `manual` modes to create the required STS resources, see xref:../rosa_install_access_delete_clusters/rosa-sts-creating-a-cluster-with-customizations.adoc#rosa-understanding-deployment-modes_rosa-sts-creating-a-cluster-with-customizations[Understanding the auto and manual deployment modes]. |
| 87 | +* For information about the update life cycle for ROSA, see xref:../rosa_architecture/rosa_policy_service_definition/rosa-life-cycle.adoc#rosa-life-cycle[{product-title} update life cycle]. |
| 88 | +//// |
| 89 | + |
| 90 | + |
| 91 | +//This content is pulled from rosa-getting-started-create-cluster-admin-user.adoc |
| 92 | +include::modules/rosa-getting-started-create-cluster-admin-user.adoc[leveloffset=+1] |
| 93 | + |
| 94 | +.Additional resource |
| 95 | + |
| 96 | +* For steps to log in to the ROSA web console, see xref:../rosa_getting_started/rosa-quickstart-guide-ui.adoc#rosa-getting-started-access-cluster-web-console_rosa-quickstart-guide-ui[Accessing a cluster through the web console]. |
| 97 | + |
| 98 | + |
| 99 | +//This content is pulled from rosa-getting-started-configure-an-idp-and-grant-access.adoc |
| 100 | +include::modules/rosa-getting-started-configure-an-idp-and-grant-access.adoc[leveloffset=+1] |
| 101 | + |
| 102 | + |
| 103 | +//This content is pulled from rosa-getting-started-configure-an-idp.adoc |
| 104 | +[discrete] |
| 105 | +include::modules/rosa-getting-started-configure-an-idp.adoc[leveloffset=+2] |
| 106 | + |
| 107 | +.Additional resource |
| 108 | + |
| 109 | +* For detailed steps to configure each of the supported identity provider types, see xref:../rosa_install_access_delete_clusters/rosa-sts-config-identity-providers.adoc#rosa-sts-config-identity-providers[Configuring identity providers for STS]. |
| 110 | + |
| 111 | + |
| 112 | +//This content is pulled from rosa-getting-started-grant-user-access.adoc |
| 113 | +[discrete] |
| 114 | +include::modules/rosa-getting-started-grant-user-access.adoc[leveloffset=+2] |
| 115 | + |
| 116 | + |
| 117 | +//This content is pulled from rosa-getting-started-grant-admin-privileges.adoc |
| 118 | +[discrete] |
| 119 | +include::modules/rosa-getting-started-grant-admin-privileges.adoc[leveloffset=+2] |
| 120 | + |
| 121 | + |
| 122 | +//This content is pulled from rosa-getting-started-access-cluster-web-console.adoc |
| 123 | +include::modules/rosa-getting-started-access-cluster-web-console.adoc[leveloffset=+1] |
| 124 | + |
| 125 | + |
| 126 | +//This content is pulled from deploy-app.adoc |
| 127 | +include::modules/deploy-app.adoc[leveloffset=+1] |
| 128 | + |
| 129 | + |
| 130 | +//This content is pulled from rosa-getting-started-revoking-admin-privileges-and-user-access.adoc |
| 131 | +include::modules/rosa-getting-started-revoking-admin-privileges-and-user-access.adoc[leveloffset=+1] |
| 132 | + |
| 133 | + |
| 134 | +//This content is pulled from rosa-getting-started-revoke-admin-privileges.adoc |
| 135 | +[discrete] |
| 136 | +include::modules/rosa-getting-started-revoke-admin-privileges.adoc[leveloffset=+2] |
| 137 | + |
| 138 | + |
| 139 | +//This content is pulled from rosa-getting-started-revoke-admin-privileges.adoc |
| 140 | +[discrete] |
| 141 | +include::modules/rosa-getting-started-revoke-user-access.adoc[leveloffset=+2] |
| 142 | + |
| 143 | + |
| 144 | +//This content is pulled from rosa-getting-started-deleting-a-cluster.adoc |
| 145 | +include::modules/rosa-getting-started-deleting-a-cluster.adoc[leveloffset=+1] |
| 146 | + |
| 147 | +[id="next-steps_{context}"] |
| 148 | +== Next steps |
| 149 | + |
| 150 | +* xref:../adding_service_cluster/adding-service.adoc#adding-service[Adding services to a cluster using the {cluster-manager} console] |
| 151 | +* xref:../rosa_cluster_admin/rosa_nodes/rosa-managing-worker-nodes.adoc#rosa-managing-worker-nodes[Managing compute nodes] |
| 152 | +* xref:../monitoring/rosa-configuring-the-monitoring-stack.adoc#rosa-configuring-the-monitoring-stack[Configuring the monitoring stack] |
| 153 | + |
| 154 | +[role="_additional-resources"] |
| 155 | +[id="additional-resources_{context}"] |
| 156 | +== Additional resources |
| 157 | + |
| 158 | +* For more information about setting up accounts and ROSA clusters using AWS STS, see xref:../rosa_planning/rosa-sts-aws-prereqs.adoc#rosa-sts-overview-of-the-deployment-workflow[Understanding the ROSA with STS deployment workflow]. |
| 159 | + |
| 160 | +* 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]. |
| 161 | + |
| 162 | +* For documentation on upgrading your cluster, see xref:../upgrading/rosa-upgrading.adoc#rosa-upgrading[Upgrading ROSA clusters]. |
0 commit comments