Rosa Installation README

rosa-installation-readme.md

Rosa Installation Readme

First, I wanted to say our docs are great, so any of my notes here will just at best be as good -- but most likely worse than the real docs.

Docs

1. Awesome Official Docs
2. ROSA Workshop - Although a bit dated, still has lots of gotchas that are still applicable

Installation

Pre Pre Setup

1. Sign up for an AWS account
2. Sign up for a Red Hat account
3. In the AWS Web Console, find ROSA in the search bar and click the Getting Started button.
4. This will then open another tab to the Red Hat website. You will now link your AWS and Red Hat accounts together.

Pre Setup

1. Download the aws cli and login with aws configure
2. Download the rosa cli and login with rosa login --token=<your-token-here>

Setup

1. Setup the AWS roles.

   rosa create account-roles --mode auto

2. Install ROSA, this is interactive, so answer all the questions. This installation takes 30 minutes.

   rosa create cluster
   # query the status of the installation with the following commands
   # ./rosa logs install -c spruce --watch
   # ./rosa describe cluster -c spruce

3. During install, create roles. Notice the --interactive flag, which means you can't script this yet as it'll ask you a bunch of questions interactively.

   # accept defaults
   rosa create operator-roles --interactive -c spruce
   # accept defaults
   rosa create oidc-provider --interactive -c spruce

4. Setup Admin Use

   rosa create admin --cluster=<whatever-you-named-your-cluster-in-step-2>

5. Setup GitHub IDP (GitHub side is outside the scope of this doc). Also notice the --interactive flag.

   rosa create idp --cluster=<whatever-you-named-your-cluster-in-step-2> --interactive