Ce contenu n'est pas disponible dans la langue sélectionnée.

Chapter 2. Tutorial: ROSA with HCP activation and account linking


This tutorial describes the process for activating Red Hat OpenShift Service on AWS (ROSA) with hosted control planes (HCP) and linking to an AWS account, before deploying the first cluster.

Important

If you have received a private offer for the product, make sure to proceed according to the instructions provided with the private offer before following this tutorial. The private offer is designed either for a case when the product is already activated, which replaces an active subscription, or for first time activations.

2.1. Prerequisites

  • Make sure to log in to the Red Hat account that you plan to associate with the AWS account where you have activated ROSA with HCP in previous steps.
  • The AWS account used for service billing can only be associated with a single Red Hat account. Typically an AWS payer account is the one that is used to subscribe to ROSA and used for account linking and billing.
  • All team members belonging to the same Red Hat organization can use the linked AWS account for service billing while creating ROSA with HCP clusters.

2.2. Subscription enablement and AWS account setup

  1. Activate the ROSA with HCP product at the AWS console page by clicking the Get started button:

    Figure 2.1. Get started

    rosa get started

    If you have activated ROSA before but did not complete the process, you can click the button and complete the account linking as described in the following steps.

  2. Confirm that you want your contact information to be shared with Red Hat and enable the service:

    Figure 2.2. Enable ROSA

    rosa enable 2
    • You will not be charged by enabling the service in this step. The connection is made for billing and metering that will take place only after you deploy your first cluster. This could take a few minutes.
  3. After the process is completed, you will see a confirmation:

    Figure 2.3. ROSA enablement confirmation

    rosa prereq enable 3
  4. Other sections on this verification page show the status of additional prerequisites. In case any of these prerequisites are not met, a corresponding message is shown. Here is an example of insufficient quotas in the selected region:

    Figure 2.4. Service quotas

    rosa service quota 4
    1. Click the Increase service quotas button or use the Learn more link to get more information about the about how to manage service quotas. In the case of insufficient quotas, note that quotas are region-specific. You can use the region switcher in the upper right corner of the web console to re-run the quota check for any region you are interested in and then submit service quota increase requests as needed.
  5. If all the prerequisites are met, the page will look like this:

    Figure 2.5. Verify ROSA prerequisites

    rosa prereq 5

    The ELB service-linked role is created for you automatically. You can click any of the small Info blue links to get contextual help and resources.

2.3. AWS and Red Hat account and subscription linking

  1. Click the orange Continue to Red Hat button to proceed with account linking:

    Figure 2.6. Continue to Red Hat

    rosa continue rh 6
  2. If you are not already logged in to your Red Hat account in your current browser’s session, you will be asked to log in to your account:

    Note

    Your AWS account must be linked to a single Red Hat organization.

    Figure 2.7. Log in to your Red Hat account

    rosa login rh account 7
    • You can also register for a new Red Hat account or reset your password on this page.
    • Make sure to log in to the Red Hat account that you plan to associate with the AWS account where you have activated ROSA with HCP in previous steps.
    • The AWS account used for service billing can only be associated with a single Red Hat account. Typically an AWS payer account is the one that is used to subscribe to ROSA and used for account linking and billing.
    • All team members belonging to the same Red Hat organization can use the linked AWS account for service billing while creating ROSA with HCP clusters.
  3. Complete the Red Hat account linking after reviewing the terms and conditions:

    Note

    This step is available only if the AWS account was not linked to any Red Hat account before.

    This step is skipped if the AWS account is already linked to the user’s logged in Red Hat account.

    If the AWS account is linked to a different Red Hat account, an error will be displayed. See Correcting Billing Account Information for HCP clusters for troubleshooting.

    Figure 2.8. Complete your account connection

    rosa rh account connection 8

    Both the Red Hat and AWS account numbers are shown on this screen.

  4. Click the Connect accounts button if you agree with the service terms.

    If this is the first time you are using the Red Hat Hybrid Cloud Console, you will be asked to agree with the general managed services terms and conditions before being able to create the first ROSA cluster:

    Figure 2.9. Terms and conditions

    rosa terms conditions 9

    Additional terms that need to be reviewed and accepted are shown after clicking the View Terms and Conditions button:

    Figure 2.10. Red Hat terms and conditions

    rosa terms conditions 9 5

    Submit your agreement once you have reviewed any additional terms when prompted at this time.

  5. The Hybrid Cloud Console provides a confirmation that AWS account setup was completed and lists the prerequisites for cluster deployment:

    Figure 2.11. Complete ROSA prerequisites

    rosa cluster create 10

    The last section of this page shows cluster deployment options, either using the rosa CLI or through the web console:

    Figure 2.12. Deploy the cluster and set up access

    rosa cli ui 12

2.4. Selecting the AWS billing account for ROSA with HCP during cluster deployment using the CLI

Important

Make sure that you have the most recent ROSA command line interface (CLI) and AWS CLI installed and have completed the ROSA prerequisites covered in the previous section. See Help with ROSA CLI setup and Instructions to install the AWS CLI for more information.

  1. Initiate the cluster deployment using the rosa create cluster command. You can click the copy button on the Set up Red Hat OpenShift Service on AWS (ROSA) console page and paste the command in your terminal. This launches the cluster creation process in interactive mode:

    Figure 2.13. Deploy the cluster and set up access

    rosa cli 15
  2. To use a custom AWS profile, one of the non-default profiles specified in your ~/.aws/credentials, you can add the –profile <profile_name> selector to the rosa create cluster command so that the command looks like rosa create cluster –profile stage. If no AWS CLI profile is specified using this option, the default AWS CLI profile will determine the AWS infrastructure profile into which the cluster is deployed. The billing AWS profile is selected in one of the following steps.
  3. When deploying a ROSA with HCP cluster, the billing AWS account needs to be specified:

    Figure 2.14. Specify the Billing Account

    rosa create cli billing 17
    • Only AWS accounts that are linked to the user’s logged in Red Hat account are shown.
    • The specified AWS account is charged for using the ROSA service.
    • An indicator shows if the ROSA contract is enabled or not enabled for a given AWS billing account.

      • If you select an AWS billing account that shows the Contract enabled label, on-demand consumption rates are charged only after the capacity of your pre-paid contract is consumed.
      • AWS accounts without the Contract enabled label are charged the applicable on-demand consumption rates.

Additional resources

2.5. Selecting the AWS billing account for ROSA with HCP during cluster deployment using the web console

  1. A cluster can be created using the web console by selecting the second option in the bottom section of the introductory Set up ROSA page:

    Figure 2.15. Deploy with web interface

    rosa deploy ui 19
    Note

    Complete the prerequisites before starting the web console deployment process.

    The rosa CLI is required for certain tasks, such as creating the account roles. If you are deploying ROSA for the first time, follow this the CLI steps until running the rosa whoami command, before starting the web console deployment steps.

  2. The first step when creating a ROSA cluster using the web console is the control plane selection. Make sure the Hosted option is selected before clicking the Next button:

    Figure 2.16. Select hosted option

    rosa deploy ui hcp 20
  3. The next step Accounts and roles allows you specifying the infrastructure AWS account, into which the ROSA cluster is deployed and where the resources are consumed and managed:

    Figure 2.17. AWS infrastructure account

    rosa ui account 21
    • Click the How to associate a new AWS account, if you don not see the account into which you want to deploy the ROSA cluster for detailed information on how to create or link account roles for this association.
    • The rosa CLI is used for this.
    • If you are using multiple AWS accounts and have their profiles configured for the AWS CLI, you can use the --profile selector to specify the AWS profile when working with the rosa CLI commands.
  4. The billing AWS account is selected in the immediately following section:

    Figure 2.18. AWS billing account

    rosa ui billing 22
    • Only AWS accounts that are linked to the user’s logged in Red Hat account are shown.
    • The specified AWS account is charged for using the ROSA service.
    • An indicator shows if the ROSA contract is enabled or not enabled for a given AWS billing account.

      • If you select an AWS billing account that shows the Contract enabled label, on-demand consumption rates are charged only after the capacity of your pre-paid contract is consumed.
      • AWS accounts without the Contract enabled label are charged the applicable on-demand consumption rates.

The following steps past the billing AWS account selection are beyond the scope of this tutorial.

Additional resources

Red Hat logoGithubRedditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez leBlog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

© 2024 Red Hat, Inc.