The Workshop Environment You Are Using
Your environment has already been set up and with the tools you need to work with ROSA and AWS.
Your workshop environment consists of several components which have been pre-configured and are ready to use. This includes an Amazon Web Services (AWS) account, and many other supporting resources.
ROSA is enabled on the AWS account used for this lab - and the ROSA CLI as well as AWS CLI tools are installed and configured on your bastion VM.
Validate installed tools
You will be using the rosa
, aws
and oc
command line tools throughout this lab.
-
Verify that the
rosa
command line tool is installed (note that your version may be a more recent version than the output shown below):rosa version
Sample Output1.2.37 Your ROSA CLI is up to date.
-
Verify that the
aws
command line tool is installed:aws --version
Sample Outputaws-cli/2.15.39 Python/3.11.8 Linux/5.14.0-362.18.1.el9_3.x86_64 exe/x86_64.rhel.9 prompt/off
-
Verify that the
aws
command line tool is configured correctly:aws sts get-caller-identity
Sample Output{ "UserId": "AIDA52VPS74UJLY4GUW7L", "Account": "950629760808", "Arn": "arn:aws:iam::950629760808:user/wkulhane@redhat.com-nhnv4" }
-
Verify that the
oc
CLI is installed correctlyrosa verify openshift-client
Sample OutputI: Verifying whether OpenShift command-line tool is available... I: Current OpenShift Client Version: 4.15.9
-
Rosa login
rosa login
Sample OutputI: Logged in as 'rhpds-cloud' on 'https://api.openshift.com'
Normally you would need to get a token from the Red Hat Console and log into ROSA using that token.
In this environment your token has been preconfigured for you.
-
Run rosa whoami to verify your credentials:
rosa whoami
Sample OutputAWS ARN: arn:aws:iam::950629760808:user/wkulhane@redhat.com-nhnv4 AWS Account ID: 950629760808 AWS Default Region: us-east-2 OCM API: https://api.openshift.com OCM Account Email: rhpds-admins+cloud@redhat.com OCM Account ID: 1z8a-------------------HD9l OCM Account Name: RHPDS Cloud OCM Account Username: rhpds-cloud OCM Organization External ID: 1234567890 OCM Organization ID: 1z8-------------------0ZL OCM Organization Name: Red Hat, Inc.
Review quota
-
You must ensure your AWS account has enough resources available to run ROSA. Use the following command to review available AWS quota:
rosa verify quota
Sample OutputI: Validating AWS quota... I: AWS quota ok. If cluster installation fails, validate actual AWS resource usage against https://docs.openshift.com/ rosa/rosa_getting_started/rosa-required-aws-service-quotas.html
See the documentation for more details regarding quotas.
You have now successfully reviewed your account and environment and are ready to work with ROSA and AWS.