Preparing a cluster to use Red Hat OpenShift Service on AWS (ROSA)


Before you begin:

  • Confirm that you have a Red Hat OpenShift account and an AWS account, with login credentials for each.

  • The version of Red Hat OpenShift Service on AWS (ROSA) that you are running must be supported. For versions of OpenShift Container Platform that are compatible with the Cloud Pak for Integration release, see Operating environment. For more information about the schedule for OpenShift Container Platform versions supported by OpenShift on AWS, see "Life cycle dates" in Red Hat OpenShift Service on AWS update life cycle.

  • Review the pages under AWS prerequisites for ROSA in the OpenShift documentation.

  • Create an AWS access ID and secret (if you do not already have them) by following the procedure in Configuration basics.

  • Follow the procedure for Configuring your AWS account. Note that after you have configured the default region, you can review the following two files to confirm the configuration is applied:

    cat ~/.aws/credentials
    aws-access-key-id = <aws_access_key_id>
    aws-secret-access-key = <aws_secret_access_key>
    cat ~/.aws/config
    region = ca-central-1
    output = json

Creating the ROSA cluster

Follow the procedure in Creating a ROSA cluster.

Note that when your cluster is created, the output includes a Details Page url that provides important details about the cluster, including nodes, OpenShift versions, and OAuth user.

If you need to install additional ROSA clusters, the OpenShift documentation offers a Command quick reference list to facilitate the process.

Creating the admin user

The procedure in this section assume you are creating an admin user in the OpenShift web console. However, if you prefer to use the command line, follow the procedure in Configuring an HTPasswd identity provider or any of the other identity provider pages in the "Configuring identity providers" section.

  1. Log into your OpenShift account at the URL that you got in the output after creating the ROSA cluster, for example:`
  1. If you see an dialog for OAuth users, click that. If not, in the navigation menu, click Clusters.

  2. Click the Access Control tab.

  3. Select an identity provider from the Add identity provider list.

  4. In the Add identity provider pane, update the details for the identity provider, then click Add.

  5. Click the newly created admin user to configure permissions.

Configuring storage

EBS and EFS may provide the optimal features for your storage cluster.

EBS is available by default on ROSA clusters and can provide volumes in RWO access mode.

EFS is supported for ROSA on OpenShift Container Platform 4.10 and later versions and can provide volumes in RWX access mode. To configure EFS storage on OpenShift 4.10, see Installing the AWS EFS CSI Driver Operator.