Lab 0: Get the IBM Cloud Container Service
Last updated
Was this helpful?
Last updated
Was this helpful?
For the hands-on labs in this tutorial repository, you will need a kubernetes cluster. One option for creating a cluster is to make use of the Kubernetes as-a-service from the IBM Cloud Kubernetes Service as outlined below.
You will need either a paid IBM Cloud account or an IBM Cloud account which is a Trial account (not a Lite account). If you have one of these accounts, use the to create your cluster.
There are a few services that are accessible over the Internet for temporary use. As these are free services, they can sometimes experience periods of limited availablity/quality. On the other hand, they can be a quick way to get started!
This environment starts with a master and worker node pre-configured. You can run the steps from Labs 1 and onward from the master node.
After signing in with your github or docker hub id, click on Start, then Add New Instance and follow steps shown in terminal to spin up the cluster and add workers.
If you would like to configure kubernetes to run on your local workstation for non-production, learning use, there are several options.
This solution requires the installation of a supported VM provider (KVM, VirtualBox, HyperKit, Hyper-V - depending on platform)
Runs a kubernetes cluster on Docker containers
Docker Desktop includes a kubernetes environment
Installable kubernetes packaged as an Ubuntu snap image.
Log in to the IBM Cloud CLI: ibmcloud login.
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.
To create Kubernetes clusters and manage worker nodes, install the IBM Cloud Kubernetes Service plug-in: ibmcloud plugin install container-service -r Bluemix
Note: The prefix for running commands by using the IBM Cloud Kubernetes Service plug-in is bx cs.
To verify that the plug-in is installed properly, run the following command: ibmcloud plugin list
The IBM Cloud Kubernetes Service plug-in is displayed in the results as container-service.
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:
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:
Move the executable file to the /usr/local/bin directory using the command mv /<path_to_file>/kubectl /usr/local/bin/kubectl .
Make sure that /usr/local/bin is listed in your PATH system variable.
Convert the binary file to an executable: chmod +x /usr/local/bin/kubectl
List the clusters in your account:
Set an environment variable that will be used in subsequent commands in this lab.
Configure kubectl to point to your cluster
Validate proper configuration
You should see output similar to the following, if so, then your're ready to continue.
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.
As a prerequisite for the IBM Cloud Kubernetes Service plug-in, install the . Once installed, you can access IBM Cloud from your command-line with the prefix bx.