Getting started with Red Hat OpenShift Service on AWS (ROSA)

Learn how to get started on Red Hat® OpenShift® Service on AWS, including how to use AWS Security Token Service (STS) to deploy a cluster.

Learn how to get started on Red Hat® OpenShift® Service on AWS, including how to use AWS Security Token Service (STS) to deploy a cluster.

Accessing your cluster in ROSA

15 mins

There are multiple ways to interact with your cluster. You can connect to it via the command-line-interface (CLI) or via the Web Console. We will review both options below.

What will you learn?

  • How to access your cluster via the Web Console

  • How to access your cluster via the CLI

What do you need before starting?

Access the cluster via the console

Screenshot of the “Administrator” panel on the OpenShift Cluster Manager console
  1. Enter the console URL into your web browser. If you need to retrieve it you can run:

    rosa describe cluster -c <cluster-name> | grep Console

  2. Click on your identity provider (IdP). In this learning path, we created “rosa-github.”
    Screenshot of the option to login using GitHub credentials
  3. Enter your GitHub user credentials (or other credentials if not using GitHub).
  4. You should now be logged in. If you've followed this learning path in order, you will be a cluster-admin and should see a web console like the following with the "Administrator" panel visible.
    Screenshot of the “Administrator” panel on the OpenShift Cluster Manager console

Access the cluster via the CLI

In order to access the cluster via the CLI you must have the oc CLI installed, which was completed in the prerequisites for this learning path.

  1. Log into the web console as stated above.
  2. Click on your username in the top right corner
  3. Click on “Copy Login Command”
Screenshot of the username dropdown menu on OpenShift Cloud Manager with a red outline around the first option, “Copy login command”
  1. This will open a new tab with a choice of IdP. Click on the IdP you want to use, in our case, “rosa-github.”
  2. A new tab will open. Click on “Display token.”
  3. You will see a page like the following:
Screenshot of the API token information
  1. oc login command and paste it into your terminal. Press enter.
  2. We can confirm that we are now the user we logged in with by running:
  
oc whoami
$ oc whoami
rosa-user
  
  1. We can now start using our cluster.

You are now ready to manage worker nodes.

 

This learning path is for operations teams or system administrators

Developers may want to check out developers.redhat.com.

Get started on developers.redhat.com