Kubernetes in 30 minutes with minikube on Mac

Below are steps to create an express setup of Kubernetes on your Mac for quick use.

Minikube is a small setup by Kubernetes guys, which will spawn a virtual machine and have a tiny (but fully functional) Kubernetes cluster inside the VM. kubectl (pronounced ‘kube (like ‘tube’) control`) is the command line client you'll use to connect to the Kubernetes cluster (which runs inside the VM created by minikube, in case you forgot :) )

Note that you need VirtualBox installed on your system. You can do so by first installing brew cask and then installing virtualbox as outlined in the two lines below, taken from here. I installed virtualbox from a different source, but the two lines below should work without a problem:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew cask install virtualbox

Minikube Installation

curl -Lo minikube https://storage.googleapis.com/minikube/releases/v0.7.1/minikube-darwin-amd64
chmod +x minikube
sudo mv minikube /usr/local/bin/

Start minikube cluster

minikube start

Just for information, config file will be located in ~/.kube/ directory, and all the virtual machine bits will be present in ~/.minikube/ directory.

Get status of minikube cluster

minikube status

Install kubectl cli

Don't install kubectl from brew (brew install kubernetes-cli) as brew contains an older incompatible version of kubectl.

curl -Lo kubectl http://storage.googleapis.com/kubernetes-release/release/v1.3.0/bin/darwin/amd64/kubectl
chmod +x kubectl
sudo mv kubectl /usr/local/bin/

List all pods from all namespaces. It should list two pods, one an ‘addon-manager’ and another a ‘dashboard’

kubectl get pods --all-namespaces

Populate environment variables so that docker can connect to minikube VM

eval $(minikube docker-env)

Now list all running docker containers inside the minikube vm. This might throw error

docker ps

If it errors with output Error response from daemon: client is newer than server (client API version: 1.24, server API version: 1.23), then we need to install an older version of docker along with the current docker server installation.

We'll use DVM (docker version manager) for the same, and we need to install DVM first for that.

brew update && brew install dvm

If brew update fails, most of the times re-running brew update again fixes the problem (else do brew upgrade && brew update and wait for an hour for it to finish depending upon your internet connection).

Now source the shell script for dvm command line tool

[[ -s "$(brew --prefix dvm)/dvm.sh" ]] && source "$(brew --prefix dvm)/dvm.sh"

View current docker version

dvm ls

Install older docker version 1.11.1

export DOCKER_VERSION=1.11.1
dvm install

Now if you do dvm ls you'll see that your current docker version is 1.11.1.

Now you can use docker ps to see all your docker containers for Kubernetes running inside minikube.

That's all for this blogpost. I'll write another blog post about how to create your own pods inside this running Kubernetes cluster.

Do let me know if you have comments/suggestions/edits/criticism/feedback.

Cheers! Rushi


comments powered by Disqus