DEV Community

Harshad Ranganathan
Harshad Ranganathan

Posted on • Updated on • Originally published at rharshad.com

Setting up Kubernetes on Windows with Minikube

Originally published at rharshad.com

Minikube is a tool that makes it easy to run Kubernetes locally. Minikube runs a single-node Kubernetes cluster inside a VM on your laptop for users looking to try out Kubernetes or develop with it day-to-day.

Minikube can be installed in multiple operating systems (Linux, MacOS & Windows) and supports multiple drivers (VirtualBox, Hyper-V in case of Windows).

We are going to look at Windows setup of Minikube using both VirtualBox & Hyper-V drivers.

If you have Docker in your local system then you would have enabled Hyper-V. In that case, it makes sense to make use of Hyper-V driver instead of VirtualBox as the latter doesn't work with Hyper-V enabled.

So, in such a case if you choose VirtualBox as your driver you might end up toggling Hyper-V and restarting your system based on whether you want to use Docker or VirtualBox for Kubernetes.

Install Chocolatey

Chocolatey is a package manager for Windows similar to how homebrew is for MacOS. It simplifies our installation process so we will use it here.

Open PowerShell as an administrator and run below commands.

# Check the execution policy and ensure that it is not restricted
Get-ExecutionPolicy

# If execution policy is restricted then set the policy to All-Signed
Set-ExecutionPolicy AllSigned

# Install chocolatey
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
Enter fullscreen mode Exit fullscreen mode

Install Minikube

Once chocolately is installed, we run below command to install Minikube

choco install minikube --version 0.27 -y
Enter fullscreen mode Exit fullscreen mode

Note: Versions above 0.27 have an issue with shutdown

Install VirtualBox

If you're planning to use VirtualBox as the driver for Minikube then run below command. Otherwise skip this step.

choco install virtualbox -y
Enter fullscreen mode Exit fullscreen mode

We'll look at running Kubernetes cluster in both VirtualBox and Hyper-V next.

Running Kubernetes Cluster in VirtualBox

Start Minikube

Run this command in PowerShell as an administrator.

minikube start --alsologtostderr
Enter fullscreen mode Exit fullscreen mode

Minikube will perform below steps

  • Downloads MinikubeISO and places it in .minikube folder in your user directory
  • Connects to VirtualBox and runs a minikube virtual machine
  • Downloads the necessary files and moves them to the cluster
  • Runs a single-node Kubernetes cluster inside the VM

Jump to Interacting With Your Cluster section next.

Troubleshooting

If you face any issues during the setup process perform below steps:

Delete the minikube VM

minikube delete
Enter fullscreen mode Exit fullscreen mode

Delete .minikube and .kube folders in your home directory

Run minikube start command with appropriate options.

Running Kubernetes Cluster in Hyper-V

Create vSwitch

First step is to create a vSwitch in Hyper-V.

Open Hyper-V Manager in your windows system. On the right pane, select Virtual Switch Manager option.

Select External and choose Create Virtual Switch option in the Virtual Switch Manager window.

Give a name for the virtual switch e.g. Minikube with connection type as External and below option enabled

  • Allow management operating system to share this network adapter

Now select Apply to create a new vSwitch.

If you see an error message Failed while adding virtual Ethernet switch connections it means that you have enabled sharing on your wifi connection which needs to be disabled.

Go to Network and Sharing Center and select your Wi-Fi connection. In the Wi-Fi status window select Properties.

In the Wi-Fi properties window under Sharing tab uncheck this option

  • Allow other network users to connect through this computer's Internet connection

Start Minikube

Run this command in PowerShell as an administrator.

minikube start --vm-driver "hyperv" --hyperv-virtual-switch "Minikube" --disk-size 10g --memory 4096 --alsologtostderr
Enter fullscreen mode Exit fullscreen mode

Minikube will perform below steps

  • Downloads MinikubeISO and places it in .minikube folder in your user directory
  • Connects to Hyper-V and runs a minikube virtual machine
  • Downloads the necessary files and moves them to the cluster
  • Runs a single-node Kubernetes cluster inside the VM

You will see below logs if everything went fine.

Connecting to cluster...
Setting up kubeconfig...
I1125 23:05:12.192115    4588 config.go:125] Using kubeconfig:  
Starting cluster components...
I1125 23:05:12.196100    4588 ssh_runner.go:80] Run with output:
sudo /usr/bin/kubeadm init --config /var/lib/kubeadm.yaml 
ts --ignore-preflight-errors=DirAvailable--data-minikube 
FileAvailable--etc-kubernetes-manifests-kube-scheduler.yaml 
fests-kube-apiserver.yaml --ignore-preflight-errors=FileAvailable
 --ignore-preflight-errors=FileAvailable--etc-kubernetes-manifests-etcd.yaml
flight-errors=CRI  &&
sudo /usr/bin/kubeadm alpha phase addon kube-dns

Kubectl is now configured to use the cluster.
Loading cached images from config file.
Enter fullscreen mode Exit fullscreen mode

Troubleshooting

If you face any issues during the setup process perform below steps:

Delete the minikube VM

minikube delete
Enter fullscreen mode Exit fullscreen mode

Delete .minikube and .kube folders in your home directory

Run minikube start command with appropriate options.

Interacting With Your Cluster

To check if minikube is running use below command

minikube status
Enter fullscreen mode Exit fullscreen mode

which outputs

PS C:\WINDOWS\system32> minikube status
minikube: Running
cluster: Running
kubectl: Correctly Configured: pointing to minikube-vm at
Enter fullscreen mode Exit fullscreen mode

To ensure all the cluster components are running we use below command

PS C:\WINDOWS\system32> kubectl get pods -n kube-system
NAME                                    READY   STATUS    RESTARTS   AGE
coredns-c4cffd6dc-565mc                 1/1     Running   0          12m
etcd-minikube                           1/1     Running   0          11m
kube-addon-manager-minikube             1/1     Running   0          11m
kube-apiserver-minikube                 1/1     Running   0          11m
kube-controller-manager-minikube        1/1     Running   0          12m
kube-dns-86f4d74b45-vxrr9               3/3     Running   0          12m
kube-proxy-fn5c9                        1/1     Running   0          12m
kube-scheduler-minikube                 1/1     Running   0          11m
kubernetes-dashboard-6f4cfc5d87-hgdnq   1/1     Running   5          12m
storage-provisioner                     1/1     Running   0          12m
Enter fullscreen mode Exit fullscreen mode

If any of the above pods are in failed status you can get it's logs as follows for debugging

kubectl logs kubernetes-dashboard-6f4cfc5d87-hgdnq -n kube-system
Enter fullscreen mode Exit fullscreen mode

If you notice any of the pods in CrashLoopBackOff status then perform the steps as mentioned in the troubleshooting guide earlier.

To access the Kubernetes dashboard run below command

minikube dashboard
Enter fullscreen mode Exit fullscreen mode

Top comments (0)