Merge pull request #43730 from bmcelvee/OSDOCS-2463

OSDOCS-2463: Update ROSA introduction

Author: bmcelvee

rosa_architecture/rosa-understanding.adoc

@@ -5,7 +5,63 @@ include::_attributes/attributes-openshift-dedicated.adoc[]
 :context: rosa-understanding
 toc::[]
 
-Learn about {product-title} (ROSA) access, supported consoles, consumption experience, and integration with Amazon Web Services (AWS) services.
+Learn about {product-title} (ROSA), interacting with ROSA using {cluster-manager-first} and command-line interface (CLI) tools, consumption experience, and integration with Amazon Web Services (AWS) services.
 
-include::modules/rosa-understanding.adoc[leveloffset=+1]
-include::modules/rosa-using-sts.adoc[leveloffset=+2]
+[id="rosa-understanding-about_{context}"]
+== About ROSA
+
+ROSA is a fully-managed, turnkey application platform that allows you to focus on delivering value to your customers by building and deploying applications. Red Hat and AWS Site reliability engineering (SRE) experts manage the underlying platform so you do not have to worry about the complexity of infrastructure management. ROSA provides seamless integration with a wide range of AWS compute, database, analytics, machine learning, networking, mobile, and other services to further accelerate the building and delivering of differentiating experiences to your customers.
+
+You subscribe to the service directly from your AWS account. After the clusters are created, you can operate your clusters with the OpenShift web console or through {cluster-manager-first}. The ROSA service also uses OpenShift APIs and command-line interface (CLI) tools. These tools provide a standardized OpenShift experience to use your existing skills and tools knowledge.
+
+You receive OpenShift updates with new feature releases and a shared, common source for alignment with OpenShift Container Platform. ROSA supports the same versions of OpenShift as Red Hat OpenShift Dedicated and OpenShift Container Platform to achieve version consistency.
+
+[id="rosa-understanding-credential-modes_{context}"]
+== Credential modes
+
+There are two supported credential modes for ROSA clusters. One uses the AWS Secure Token Service (STS), which is recommended, and the other uses Identity Access Management (IAM) roles.
+
+[id="rosa-understanding-aws-sts_{context}"]
+=== ROSA with STS
+
+AWS STS is a global web service that provides short-term credentials for IAM or federated users. ROSA with STS is the recommended credential mode for ROSA clusters. You can use AWS STS with ROSA to allocate temporary, limited-privilege credentials for component-specific IAM roles. The service enables cluster components to make AWS API calls using secure cloud resource management practices.
+
+You can use the `rosa` CLI to create the IAM role, policy, and identity provider resources that are required for ROSA clusters that use STS.
+
+AWS STS aligns with principles of least privilege and secure practices in cloud service resource management. The `rosa` CLI manages the STS credentials that are assigned for unique tasks and takes action upon AWS resources as part of OpenShift functionality. One limitation of using STS is that roles must be created for each ROSA cluster.
+
+A listing of the account-wide and per-cluster roles is provided in xref:../rosa_architecture/rosa-sts-about-iam-resources.adoc#rosa-sts-about-iam-resources[About IAM resources for ROSA clusters that use STS].
+
+[id="rosa-understanding-aws-without-sts_{context}"]
+=== ROSA without STS
+
+This mode makes use of a pre-created IAM user with `AdministratorAccess` within the account that has proper permissions to create other roles and resources as needed. Using this account the service creates all the necessary resources that are needed for the cluster.
+
+[id="rosa-understanding-billing-pricing_{context}"]
+== Billing and pricing
+
+ROSA is billed directly to your AWS account. ROSA pricing can be consumption based, with annual commitments or three-year commitments for greater discounting. The total cost of ROSA consists of two components:
+
+* ROSA service fees
+* AWS infrastructure fees
+
+Visit the link:https://aws.amazon.com/rosa/pricing/[AWS pricing page] for more details.
+
+[id="rosa-understanding-getting-started_{context}"]
+== Getting started
+
+To get started with deploying your cluster, ensure your AWS account has met the prerequisites, you have a Red Hat account ready, and follow the procedures outlined in xref:../rosa_getting_started/rosa-getting-started.adoc#rosa-getting-started[Getting started with {product-title}].
+
+[discrete]
+[role="_additional-resources"]
+== Additional resources
+
+* xref:../ocm/ocm-overview.adoc#ocm-overview[OpenShift Cluster Manager]
+* xref:../rosa_architecture/rosa-sts-about-iam-resources.adoc#rosa-sts-about-iam-resources[About IAM resources for ROSA clusters that use STS]
+* xref:../rosa_getting_started/rosa-getting-started.adoc#rosa-getting-started[Getting started with {product-title}]
+* link:https://aws.amazon.com/rosa/pricing/[AWS pricing page]
+
+
+// Remove these modules?
+//include::modules/rosa-understanding.adoc[leveloffset=+1]
+//include::modules/rosa-using-sts.adoc[leveloffset=+2]

welcome/index.adoc

@@ -5,7 +5,21 @@ include::_attributes/common-attributes.adoc[]
 :context: welcome-index
 
 [.lead]
+ifndef::openshift-rosa[]
 Welcome to the official {product-title} {product-version} documentation, where you can learn about {product-title} and start exploring its features.
+endif::openshift-rosa[]
+ifdef::openshift-rosa[]
+Welcome to the official {product-title} (ROSA) documentation, where you can learn about ROSA and start exploring its features.
+To learn about ROSA, interacting with ROSA using {cluster-manager-first} and command-line interface (CLI) tools, consumption experience, and integration with Amazon Web Services (AWS) services, start with xref:../rosa_architecture/rosa-understanding.adoc#rosa-understanding[the Introduction to ROSA documentation].
+endif::[]
+
+ifdef::openshift-rosa[]
+To navigate the ROSA documentation, use the left navigation bar.
+
+For documentation that is not ROSA-specific, see the link:https://docs.openshift.com/container-platform/latest/welcome/index.html[OpenShift Container Platform documentation].
+endif::[]
+
+ifndef::openshift-rosa[]
 
 ifndef::openshift-rosa,openshift-dedicated,openshift-dpu[]
 To navigate the {product-title} {product-version} documentation, you can use one of the following methods:
@@ -14,12 +28,6 @@ To navigate the {product-title} {product-version} documentation, you can use one
 * Select the task that interests you from the contents of this Welcome page.
 endif::openshift-rosa,openshift-dedicated,openshift-dpu[]
 
-ifdef::openshift-rosa[]
-To navigate the {product-title} (ROSA) documentation, use the left navigation bar.
-
-For documentation that is not ROSA-specific, see the link:https://docs.openshift.com/container-platform/latest/welcome/index.html[OpenShift Container Platform documentation].
-endif::[]
-
 ifdef::openshift-dpu[]
 To navigate the {product-title} data processing unit (DPU) documentation, use the left navigation bar.
 
@@ -190,7 +198,7 @@ xref:../operators/operator_sdk/helm/osdk-helm-support.adoc#osdk-helm-support[Hel
 endif::[]
 endif::[]
 
-ifdef::openshift-rosa,openshift-dedicated[]
+ifdef::openshift-dedicated[]
 == Developer activities
 Ultimately, {product-title} is a platform for developing and deploying containerized applications. As an application developer, {product-title} and OpenShift Container Platform documentation helps you:
 
@@ -293,7 +301,7 @@ After configuring monitoring, use the web console to access xref:../monitoring/r
 - **xref:../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring_about-remote-health-monitoring[Remote health monitoring]**: {product-title} collects anonymized aggregated information about your cluster. Using Telemetry and the Insights Operator, this data is received by Red Hat and used to improve {product-title}. You can view the xref:../support/remote_health_monitoring/showing-data-collected-by-remote-health-monitoring.adoc#showing-data-collected-by-remote-health-monitoring_showing-data-collected-by-remote-health-monitoring[data collected by remote health monitoring].
 endif::[]
 
-ifdef::openshift-rosa,openshift-dedicated[]
+ifdef::openshift-dedicated[]
 == Cluster administrator activities
 
 While cluster maintenance and host configuration is performed by the Red Hat Site Reliability Engineering (SRE) team, other ongoing tasks on your {product-title} {product-version} cluster can be performed by {product-title} cluster administrators. As an {product-title} cluster administrator, the documentation helps you:
@@ -303,3 +311,5 @@ While cluster maintenance and host configuration is performed by the Red Hat Sit
 - *Monitor clusters*: Learn to use the Web UI to access monitoring dashboards.
 - *Manage nodes*: Learn to manage nodes, including configuring machine pools and autoscaling.
 endif::[]
+
+endif::openshift-rosa[]