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
rosacommand line tool is installed (note that your version may be a more recent version than the output shown below):rosa versionSample Output1.2.37 Your ROSA CLI is up to date. -
Verify that the
awscommand line tool is installed:aws --versionSample 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
awscommand line tool is configured correctly:aws sts get-caller-identitySample Output{ "UserId": "AIDA52VPS74UJLY4GUW7L", "Account": "950629760808", "Arn": "arn:aws:iam::950629760808:user/wkulhane@redhat.com-nhnv4" } -
Verify that the
ocCLI is installed correctlyrosa verify openshift-clientSample OutputI: Verifying whether OpenShift command-line tool is available... I: Current OpenShift Client Version: 4.15.9 -
Rosa login
rosa loginSample 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 whoamiSample 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 quotaSample 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.htmlSee 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.