Tutorial on Using Kubernetes
The presentation that accompanies this workshop is available here:
Power Point for Docker and Kubernetes Dojo
A decent understanding of Docker at least at a high level is required. If you want to understand Docker better by going through hands on exercises check out our Docker Dojo here: Docker Dojo
Generally speaking you need to have the Git client and Docker along with Kubernetes installed locally.
Some basic skills working with command line tooling are required to complete this tutorial as you will interact with the CLI often throughout. Windows Command prompt or Powershell is recommended for Window's users. MacOS and Linux users can use their shell of choice. It will be called out where there is a difference in CLI statements for Windows vs MacOS/Linux users.
If you don't already have a Git Client, you can download the Git tools from here:
We highly recommend using Docker Desktop and after installing it be sure to enable Kubernetes. If you use a Kubernetes distribution other than what comes with Docker Desktop, the labs should all still work, but we may not be able to provide technical support.
Here are links and instructions per operating system:
-
Windows 10 64-bit: Pro, Enterprise, or Education (Build 15063 or later)
- Docker Desktop Download which Includes Kubernetes: https://www.docker.com/products/docker-desktop
- Docker Desktop Install Guide - https://docs.docker.com/docker-for-windows/install/
Proxy Configuration If you must setup Docker Desktop behind a proxy, set the proxy configuration before enabling Kubernetes. To configure the proxy, set your proxy in Docker Desktop as well as environment varialbes. You need to set your proxy information as the "http_proxy" and "https_proxy" environemnt variables as well as in Docker Desktop. You can use the "no_proxy" environment variable to specify domains/urls that do not need to go through the proxy. Be sure to restart Docker after setting the proxy information and then you can enable Kubernetes in Docker Desktop. - Enable Kubernetes (Don't miss this step!)
-
Older Windows Versions(Only if not on Windows 10 or higher):
- Docker Toolbox: https://docs.docker.com/toolbox/toolbox_install_windows/
- Kubernetes Support via Minikube(Click on the Windows tab under each section): https://kubernetes.io/docs/tasks/tools/install-minikube/
- Blog on working with Minikube on Windows: https://rominirani.com/tutorial-getting-started-with-kubernetes-on-your-windows-laptop-with-minikube-3269b54a226
- Docker Desktop for Mac : https://hub.docker.com/editions/community/docker-ce-desktop-mac
Run the docker version command and you should see something like this(yours should have newer version numbers):
C:\Users\Barry>docker version
Client: Docker Engine - Community
Version: 19.03.5
API version: 1.40
Go version: go1.12.12
Git commit: 633a0ea
Built: Wed Nov 13 07:22:37 2019
OS/Arch: windows/amd64
Experimental: false
Server: Docker Engine - Community
Engine:
Version: 19.03.5
API version: 1.40 (minimum version 1.12)
Go version: go1.12.12
Git commit: 633a0ea
Built: Wed Nov 13 07:29:19 2019
OS/Arch: linux/amd64
Experimental: false
containerd:
Version: v1.2.10
GitCommit: b34a5c8af56e510852c35414db4c1f4fa6172339
runc:
Version: 1.0.0-rc8+dev
GitCommit: 3e425f80a8c931f88e6d94a8c831b9d5aa481657
docker-init:
Version: 0.18.0
GitCommit: fec3683
Kubernetes:
Version: v1.14.8
StackAPI: v1beta2
Test kubernetes by running the kubectl get nodes command. This should show you one worker node running on your machine:
C:\Users\Barry>kubectl get nodes
NAME STATUS ROLES AGE VERSION
docker-desktop Ready master 45d v1.14.8
Lastly to make sure you don't have to spend a lot of time downloading Docker images the day of the labs, please run the following Docker Pull commands to prefetch the docker images we will be working with:
docker pull nginx
docker pull redis
docker pull javaplus/cloud-native-demo
docker pull javaplus/cloud-native-demo:1If these both work, you should be ready to go.
You will be editing YAML files and viewing Python code during the course of this exercise. You can use any text editor, but Visual Studio Code is recommended.
This is a useful, but not required, Chrome extension for viewing JSON output in your browser.
Install using a Chrome browser
This exercise has introduced you to some of the most commonly used features of Kubernetes for configuring and hosting applications using declarative, Infrastructure as Code techniques. Even what we've shown here only begins to scratch the surface. Here are other topics you'll want to dig deeper on as you continue your Kubernetes journey.