Cloud Workshop + Cloud Shell Setup Instructions

This section will guide you through the pre-requisites and setup of the environment used in this workshop labs. It is broken up into the following steps:

1. Sign up for IBM Cloud

2. Access a cluster

3. Configure CLI Tools

1. Sign up for IBM Cloud

You will need an IBM Cloud ID for the workshop. If you already have an IBM Cloud ID, proceed to the next section. To create an ID:

• Follow the steps outlined in NEWACCOUNT.

2. Kubernetes Cluster

For the hands-on labs, you will be given access to a temporary free kubernetes cluster that was pre-created for the purpose of the workshop. The cluster will be deleted after the workshop. To gain access to this cluster:

• Open the URL that was provided to you by the instructor to access your cluster.

Welcome to IBM Cloud

• Enter the workshop code provided by the workshop instructor and your IBM Cloud account IBM id. Select the terms and conditions checkbox and click the Submit button

• You will be added to a cloud account where a cluster has been pre-provisioned for you. Click on the link in the instructions which ask you to Log in to this IBM Cloud account.

Congratulations, You have been assigned a kubernetes cluster

• If you previously logged in to the IBM Cloud, the browser will direct you to the IBM Cloud resource list view (if you have not logged in previously, you will be asked to log in using your IBM Cloud ID). Expand the Clusters section and select the cluster assigned to you (the name will vary).

Clusters

• Details for your cluster will load. Click on the Access menu item in the left navigation column, where you can find instructions to access your cluster from the command line client.

Cluster Access

• Note the name of your cluster, you will use this cluster for this lab.

3. Command Line Tools / Cloud Shell

For the CLI environment we will be using preconfigured web-terminals-in-a-browser environments with all the dependencies you will need to complete the lab. Your instructor will share URL assignments for these environments.

• Log into IBM Cloud by using the ibmcloud login command. If you use federated login, add --sso to the command.

    ibmcloud login

  Note: When asked to select an account, choose AdvoWork*

• Run the ibmcloud ks clusters command to view your cluster

   ibmcloud ks clusters

  Note: If no clusters are shown, make sure you are targeting the correct IBM account in the top right corner.

• For convenience, export your cluster name as an environment variable.

   export CLUSTER_NAME=<your_cluster_name>

• We can now configure the kubectl cli available within the terminal for access to your cluster. If you stored your cluster name to an environment variable (ie. $CLUSTER_NAME), use that variable, otherwise copy and paste your cluster name from the previous commands output to the $CLUSTER_NAME portion below.

   ibmcloud ks cluster config --cluster $CLUSTER_NAME

• Verify access to the Kubernetes API by getting the namespaces.

   kubectl get namespace

• You should see output similar to the following, if so, then your're ready to continue.

NAME              STATUS   AGE
default           Active   125m
ibm-cert-store    Active   121m
ibm-system        Active   124m
kube-node-lease   Active   125m
kube-public       Active   125m
kube-system       Active   125m

You should now be read to start with labs.

Note: Every time you log in to the Cloud Shell (or your CLI tools), you must run the above commands to connect with the cluster in IBM Cloud.