Get the IBM Cloud Kubernetes Service

Before you begin learning, you need to install the required CLIs to create and manage your Kubernetes clusters in IBM Cloud Container Service and to deploy containerized apps to your cluster.

This lab includes the information for installing the following CLIs and plug-ins:

• IBM Cloud CLI, Version 1 or later

• IBM Cloud Container Service plug-in

• Kubernetes CLI, Version 1.18 or later

If you already have the CLIs and plug-ins, you can skip this lab and proceed to the next one.

Install the IBM Cloud command-line interface

1. As a prerequisite for the IBM Cloud Container Service plug-in, install the IBM Cloud command-line interface. Once installed, you can access IBM Cloud from your command-line with the prefix ibmcloud. NOTE: You can install volaka/ibmcloud-devtools:1.0.0 docker image which comes with preinstalled IBM Cloud command-line interface.

2. Log in to the IBM Cloud CLI: ibmcloud login.

3. Enter your IBM Cloud credentials when prompted.

Note: If you have a federated ID, use ibmcloud login --sso to log in to the IBM Cloud CLI. Enter your user name, and use the provided URL in your CLI output to retrieve your one-time passcode. You know you have a federated ID when the login fails without the --sso and succeeds with the --sso option.

Install the IBM Cloud Container Service plug-in

1. To create Kubernetes clusters and manage worker nodes, install the IBM Cloud Container Service plug-in: ibmcloud plugin install container-service -r Bluemix

   Note: The prefix for running commands by using the IBM Cloud Container Service plug-in is ibmcloud cs.

2. To verify that the plug-in is installed properly, run the following command: ibmcloud plugin list

   The IBM Cloud Container Service plug-in is displayed in the results as container-service.

Download the Kubernetes CLI

To view a local version of the Kubernetes dashboard and to deploy apps into your clusters, you will need to install the Kubernetes CLI that corresponds with your operating system:

• OS X

• Linux

• Windows

For Windows users: Install the Kubernetes CLI in the same directory as the IBM Cloud CLI. This setup saves you some filepath changes when you run commands later.

For OS X and Linux users:

1. Move the executable file to the /usr/local/bin directory using the command mv /<path_to_file>/kubectl /usr/local/bin/kubectl .

2. Make sure that /usr/local/bin is listed in your PATH system variable.

   $echo $PATH
   /usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

3. Convert the binary file to an executable: chmod +x /usr/local/bin/kubectl

Download the Workshop Source Code

Repo guestbook has the application that we'll be deploying. While we're not going to build it we will use the deployment configuration files from that repo. Guestbook application has two versions v1 and v2 which we will use to demonstrate some rollout functionality later. All the configuration files we use are under the directory guestbook/v1.

Repo kube101 contains the step by step instructions to run the workshop.

$ git clone https://github.com/IBM/guestbook.git
$ git clone https://github.com/IBM/kube101.git