Creating your cluster

You can create an Red Hat OpenShift Service on AWS cluster using rosa.

Prerequisites

You have completed the installation prerequisites.

AWS Shared VPCs are not currently supported for ROSA installs.

Procedure
  1. Enter the following command to create your cluster with the default cluster settings.

    $ rosa create cluster --cluster-name=rh-rosa-test-cluster1

    Multiple availability zones (AZ) are recommended for production workloads. The default is a single availability zone. Use --help for an example of how to set this option manually or use interactive mode to be prompted for this setting.

    To view other options when creating a cluster, enter rosa create cluster --help.

    To follow a set of interactive prompts, enter rosa create cluster --interactive.

    Example output
    I: Creating cluster with identifier '1de87g7c30g75qechgh7l5b2bha6r04e' and name 'rh-rosa-test-cluster1'
    I: To view list of clusters and their status, run `rosa list clusters`
    I: Cluster 'rh-rosa-test-cluster1' has been created.
    I: Once the cluster is 'Ready' you will need to add an Identity Provider and define the list of cluster administrators. See `rosa create idp --help` and `rosa create user --help` for more information.
    I: To determine when your cluster is Ready, run `rosa describe cluster rh-rosa-test-cluster1`.

    Creating a cluster can take up to 40 minutes.

  2. Enter the following command to check the status of your cluster. During cluster creation the State field from the output will transition from pending to installing, and finally to ready.

    $ rosa describe cluster rh-rosa-test-cluster1
    Example output
    Name: rh-rosa-test-cluster1
    OpenShift Version: 4.6.8
    DNS: *.example.com
    ID: uniqueidnumber
    External ID: uniqueexternalidnumber
    AWS Account: 123456789101
    API URL: https://api.rh-rosa-test-cluster1.example.org:6443
    Console URL: https://console-openshift-console.apps.rh-rosa-test-cluster1.example.or
    Nodes: Master: 3, Infra: 2, Compute: 2
    Region: us-west-2
    Multi-AZ: false
    State: ready
    Channel Group: stable
    Private: No
    Created: Jan 15 2021 16:30:55 UTC
    Details Page: https://cloud.redhat.com/examplename/details/idnumber

    If installation fails or the State field does not change to ready after 40 minutes, check the installation troubleshooting documentation for more details.

  3. Enter the following command to follow the OpenShift installer logs to track the progress of your cluster:

    $ rosa logs install rh-rosa-test-cluster1 --watch