Add a Windows worker node to MicroK8s

MicroK8s supports running Windows workloads. This guide will go through the process of joining a Windows Server 2019 node to an existing MicroK8s cluster running Calico.

Prerequisites

Prepare MicroK8s

In order for Windows pods to schedule, strict affinity must be set to true. This is required to prevent Linux nodes from borrowing IP addresses from Windows nodes. This can be set with the calicoctl binary.

Export kubeconfig

To access the cluster, calicoctl will need a copy of the kubeconfig from MicroK8s. This can be made in any location - this example copies it to the default path:

mkdir -p ~/.kube
microk8s config > ~/.kube/config

Set affinity

Now strict affinity can be set to true. Be sure to point calicoctl to the Kubernetes API, rather than directly to Etcd.

DATASTORE_TYPE=kubernetes KUBECONFIG=~/.kube/config calicoctl ipam configure --strictaffinity=true

(replace the path for the kube config file if you saved it in a different location)

Gather the Kubernetes version

At a later stage, you will need to know the exact version of Kubernetes installed. This can be grabbed from MicroK8s.

microk8s kubectl get node $(hostname)

Note the output in the format X.X.X, e.g. 1.19.3.

Install components on the Windows node

You are now ready to install Calico onto the Windows node. This will also install Kubernetes components required for a working node.
All code snippets here should be run in PowerShell running as Administrator.

Create directory for Kubernetes

All Kubernetes components will be installed into this directory.

mkdir C:\k\

In here, place the kubeconfig file previously exported from MicroK8s. Be careful as some editors may try to append file extensions. You can test that it has been named correctly by trying to print the contents after you’ve saved it:

cat C:\k\config

Install

The Calico Project provides a helper script to fetch all the required binaries and services. Official documentation is available for this script, but the required steps are covered here.

First, download the script.

Invoke-WebRequest https://docs.projectcalico.org/scripts/install-calico-windows.ps1 -OutFile C:\install-calico-windows.ps1

You can then run the script with the required parameters. Change the -KubeVersion argument to the version noted earlier.

C:\install-calico-windows.ps1 -DownloadOnly yes -KubeVersion 1.19.3

Register the Calico services.

C:\CalicoWindows\install-calico.ps1

Then register the Kubernetes services so they come up with the node.

C:\CalicoWindows\kubernetes\install-kube-services.ps1

This script won’t start the Kubernetes services. Let’s do that now:

Start-Service kubelet
Start-Service kube-proxy

Cleanup

Remove the temporary files created in the previous steps:

rm C:\install-calico-windows.ps1
rm C:\calico-windows.zip

Finish

You can verify the node come up on the cluster by switching back to the MicroK8s node and running the command:

microk8s kubectl get no -o wide
4 Likes

Thanks for the tutorial.
Was finally able to get the windows host joined into microk8s and deploy an example windows pod running mcr.microsoft.com/windows/servercore:1809 :slight_smile:

1 Like