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.
- MicroK8s cluster with Calico CNI (default in 1.19 and onwards).
calicoctlinstalled on the same host as MicroK8s (see the official documentation for install instructions).
- Windows Server 2019 with Docker running on the system.
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
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
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
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.
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:
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.
Then register the Kubernetes services so they come up with the node.
This script won’t start the Kubernetes services. Let’s do that now:
Start-Service kubelet Start-Service kube-proxy
Remove the temporary files created in the previous steps:
rm C:\install-calico-windows.ps1 rm C:\calico-windows.zip
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
Last updated 6 days ago. Help improve this document in the forum.