1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/modules/rosa-sts-aws-requirements-creating-multi-association.adoc

50 lines
1.7 KiB
Plaintext

// Module included in the following assemblies:
//
// * support/rosa-troubleshooting-iam-resources.adoc
// * rosa_planning/rosa-sts-ocm-role.adoc
// * rosa_planning/rosa-sts-aws-prereqs.adoc
:_mod-docs-content-type: PROCEDURE
[id="rosa-associating-multiple-account_{context}"]
= Associating multiple AWS accounts with your Red{nbsp}Hat organization
[role="_abstract"]
You can associate multiple AWS accounts with your Red{nbsp}Hat organization. Associating multiple accounts lets you create {product-title} clusters on any of the associated AWS accounts from your Red{nbsp}Hat organization.
With this capability, you can create clusters on different AWS profiles according to characteristics that make sense for your business, for example, by using one AWS profile for each region to create region-bound environments.
.Prerequisites
* You have an AWS account.
* You are using {cluster-manager-url} to create clusters.
* You have the permissions required to install AWS account-wide roles.
* You have installed and configured the latest AWS CLI (`aws`) and {rosa-cli-first} on your installation host.
* You have created the `ocm-role` and `user-role` IAM roles for {product-title}.
.Procedure
* To specify an AWS account profile when creating an {cluster-manager} role:
+
[source,terminal]
----
$ rosa create --profile <aws_profile> ocm-role
----
* To specify an AWS account profile when creating a user role:
+
[source,terminal]
----
$ rosa create --profile <aws_profile> user-role
----
* To specify an AWS account profile when creating the account roles:
+
[source,terminal]
----
$ rosa create --profile <aws_profile> account-roles
----
+
[NOTE]
====
If you do not specify a profile, the default AWS profile and its associated AWS region are used.
====