Setup Guide
Docker Containers and Kubernetes
Fundamentals
Docker / Docker Hub Account
You’ll need a free Docker account. This account will also give you access to Docker Hub.
https://hub.docker.com/
Laptop – Hardware
A laptop supporting virtualization.
You’ll need Administrator rights on the machine.
Note that corporate locked down machines may not grant you enough privileges to run some tools used
in this course.
KUBERNETESACADEMY.ONLINE | © COPYRIGHT AZCODE, ALL RIGHTS RESERVED 1
Setup Guide
Windows Requirements
A laptop supporting virtualization, with Windows 10 or 11 and the latest updates.
OPTION 1 - Windows Subsystem for Linux 2
The recommended way of running Docker Desktop on a Windows machine by running it using WSL 2.
The requirements are:
• Windows 10 Version 2004 or higher, with Build 19041 or higher
or
• Windows 11
• Virtualization enabled
Refer to the documentation for the complete step-by-step installation instructions:
https://docs.microsoft.com/en-us/windows/wsl/install
It’s important to limit the max memory and CPU that WSL can use by creating a config file.
Create a file named .wslconfig (that’s dot wslconfig, no extension) in your C:\users\[YourUser]\ folder
Paste this suggested configuration:
[wsl2]
memory=2GB
processors=2
Save the file and restart WSL by typing:
wsl --shutdown
wsl
KUBERNETESACADEMY.ONLINE | © COPYRIGHT AZCODE, ALL RIGHTS RESERVED 2
Setup Guide
OPTION 2 – Hyper-V
Docker Desktop will also run by using an Hyper-V virtual machine on laptops/PC that don’t have WSL 2
installed.
You can see if virtualization is enabled in Task manager.
To enable it, press the Windows key and type “turn windows features on or off” and click on it to open
it. Check Hyper-V and reboot.
KUBERNETESACADEMY.ONLINE | © COPYRIGHT AZCODE, ALL RIGHTS RESERVED 3
Setup Guide
Chocolatey
Chocolatey is a package manager for Windows. Installation instructions are found here:
https://chocolatey.org/install
Note that corporate locked down machines may not grant you enough privileges to install Chocolatey.
Make sure to run a Command or a Powershell Prompt as an admin when installing packages.
Already using Chocolatey? Make sure to update your already installed packages.
choco upgrade all -y
KUBERNETESACADEMY.ONLINE | © COPYRIGHT AZCODE, ALL RIGHTS RESERVED 4
Setup Guide
macOS
macOS 10.15 and higher. Using the latest version is recommended.
Mac with Intel chip or Apple Silicon can run Docker Desktop.
Refer to the Docker Desktop system requirements page: https://docs.docker.com/docker-for-mac/install/
Note that other tools used in this course may not yet work on Apple Silicon.
Brew
Brew is a package manager for macOS. Installation instructions are found here:
https://brew.sh/
Linux
Ubuntu Desktop 18.04.x or later.
Snap
Snap is a package manager for Ubuntu and it should already be installed. To validate open a terminal,
type snap to validate. If not, install it using:
sudo apt update
sudo apt install snapd
KUBERNETESACADEMY.ONLINE | © COPYRIGHT AZCODE, ALL RIGHTS RESERVED 5
Setup Guide
Docker
On Windows and macOS, install Docker Desktop.
https://www.docker.com/products/docker-desktop
Docker Compose will be installed by this installation.
On Ubuntu, you can install the Docker engine or Docker Desktop
Docker Engine
Refer to the documentation for the latest installation instructions:
https://docs.docker.com/engine/install/ubuntu/
Next install Docker Compose:
sudo apt install docker-compose
Docker Desktop
https://docs.docker.com/desktop/install/linux-install/
KUBERNETESACADEMY.ONLINE | © COPYRIGHT AZCODE, ALL RIGHTS RESERVED 6
Setup Guide
Visual Studio Code
Install Visual Studio Code on your machine.
https://code.visualstudio.com/
After installing Code, you need to install the Docker extension.
Launch Code and install the Docker extension
1. Click on the Extensions tabs
2. Search for Docker
3. Select the Docker extension
4. Install it
KUBERNETESACADEMY.ONLINE | © COPYRIGHT AZCODE, ALL RIGHTS RESERVED 7
Setup Guide
Kubernetes – Docker Desktop
Open Docker Desktop and enable Kubernetes. This will download and install additional files and
containers in your Docker Desktop installation.
Windows
On Windows, make sure that Docker is using Linux containers. To validate, right-click on the Docker icon
in the system tray and if you see Switch to Windows containers…, you’re OK
Open Docker Desktop and enable Kubernetes.
KUBERNETESACADEMY.ONLINE | © COPYRIGHT AZCODE, ALL RIGHTS RESERVED 8
Setup Guide
MacOS
KUBERNETESACADEMY.ONLINE | © COPYRIGHT AZCODE, ALL RIGHTS RESERVED 9
Setup Guide
Kubernetes – Docker Engine
If you installed Docker Engine, your have multiples choices: Minikube, MicroK8s and Kind amongst many
other. Minikube requires visualization while MicroK8s and Kind do not. MicroK8s is super easy to install
but the choice is yours!
MicroK8s
https://ubuntu.com/kubernetes/install
sudo snap install microk8s –classic
sudo snap alias microk8s.kubectl kubectl
Minikube (requires virtualization)
https://minikube.sigs.k8s.io/docs/start/
Install Kubernetes with Minikube on VirtualBox using these commands:
sudo apt-get update
sudo apt-get install -y apt-transport-https
sudo apt-get install -y virtualbox virtualbox-ext-pack
curl -Lo minikube https://storage.googleapis.com/minikube/releases/v0.28.2/minikube-linux-amd64
chmod +x minikube && sudo mv minikube /usr/local/bin/
minikube start
Kind
https://kind.sigs.k8s.io/docs/user/quick-start/
curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.11.1/kind-linux-amd64
chmod +x ./kind
# move to a folder in your path
mv ./kind /some-dir-in-your-PATH/kind
# create a cluster with the default name “kind”
kind create cluster
KUBERNETESACADEMY.ONLINE | © COPYRIGHT AZCODE, ALL RIGHTS RESERVED 10
Setup Guide
Kubebernetes CLI and other tools
Install the following tools:
Windows
The Kubernetes CLI should be installed by Docker Desktop. To confirm, open a terminal and type kubectl.
If not installed, you can install it using chocolatey.
choco install kubernetes-cli
Also install these tools:
choco install k9s
choco install lens
MacOS
The Kubernetes CLI should be installed by Docker Desktop. To confirm, open a terminal and type kubectl.
If not installed, you can install it using Brew.
brew install kubectl
Also install these tools:
brew install --cask lens
brew install derailed/k9s/k9s
Ubuntu
snap install kubectl –classic
Install K9s using the instructions found here:
https://github.com/derailed/k9s
KUBERNETESACADEMY.ONLINE | © COPYRIGHT AZCODE, ALL RIGHTS RESERVED 11
Setup Guide
Windows – Optional tools
Optionally, you can install Windows versions of these Unix tools. They will prove very useful.
Before installing these, open a terminal and type the commands (curl, grep and sed) to see if they are
already installed or not.
choco install curl
choco install grep
choco install sed
Windows Terminal
It is highly recommended that you use the Windows Terminal. It’s much better than the old Command
Prompt and it’s available for free from the Windows Store. On Windows 11, Terminal is installed by
default.
https://docs.microsoft.com/en-us/windows/terminal/get-started
KUBERNETESACADEMY.ONLINE | © COPYRIGHT AZCODE, ALL RIGHTS RESERVED 12
Setup Guide
Checklist
Use this checklist to validate your installation.
I have a Docker account and I can log to https://hub.docker.com
On Windows, I have installed Chocolatey and if I type choco at the
command prompt/terminal I get some information and no errors
On macOS, I have installed Brew and if I type brew at the command
prompt/terminal I get some information and no errors
I have installed Visual Studio Code and can launch it
I have installed Docker Desktop and if I type docker at the command
prompt/terminal I get some information and no errors
I have installed the Docker Engine instead of Docker Desktop and if I type
docker at the command prompt/terminal I get some information and no
errors
On Windows or macOS, I have enabled Kubernetes in Docker Desktop
I have enabled Kubernetes in Docker Desktop
I have kubectl and if I type kubectl at the command prompt/terminal I get
some information and no errors
KUBERNETESACADEMY.ONLINE | © COPYRIGHT AZCODE, ALL RIGHTS RESERVED 13
