Skip to main content
Calico Open Source 3.29 (latest) documentation

Kind multi-node install

Big picture​

This tutorial gets you a multi node Kind cluster with Calico in approximately 10 minutes.

Value​

kind is a tool for running local Kubernetes clusters using Docker container "nodes".

The geeky details of what you get:

PolicyIPAMCNIOverlayRoutingDatastore

Before you begin​

How to​

Create a multi-node kind cluster​

KIND ships with a simple networking implementation ("kindnetd") based around standard CNI plugins (ptp, host-local, …) and simple netlink routes. You need to disable the default CNI to use Calico CNI.

Kind cluster creation can be modified by configuration file. Here you are providing kind configuration to disable simple networking implementation (default CNI) and change the pod ip CIDR.

  1. Disable the default CNI to use Calico CNI by running the following command:
cat > values.yaml <<EOF
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
- role: control-plane
- role: worker
- role: worker
networking:
  disableDefaultCNI: true
  podSubnet: 192.168.0.0/16
EOF
  1. Start your Kind cluster with one control plane and two worker nodes by running the following command:
kind create cluster --config values.yaml --name dev
  1. Confirm that you now have three nodes in your cluster by running the following command:
kubectl get nodes -o wide

It should return something like the following.

NAME                STATUS      ROLES           AGE    VERSION   INTERNAL-IP   EXTERNAL-IP   OS-IMAGE             KERNEL-VERSION    CONTAINER-RUNTIME
dev-control-plane   NotReady    control-plane   4m     v1.25.0   172.18.0.2    <none>        Ubuntu 22.04.1 LTS   5.10.0-17-amd64   containerd://1.6.7
dev-worker          NotReady    <none>          4m     v1.25.0   172.18.0.4    <none>        Ubuntu 22.04.1 LTS   5.10.0-17-amd64   containerd://1.6.7
dev-worker2         NotReady    <none>          4m     v1.25.0   172.18.0.3    <none>        Ubuntu 22.04.1 LTS   5.10.0-17-amd64   containerd://1.6.7

Install Calico​

  1. Install the Calico operator and custom resource definitions.
kubectl create -f https://raw.githubusercontent.com/projectcalico/calico/v3.29.1/manifests/tigera-operator.yaml
  1. Install Calico by creating the necessary custom resource. For more information on configuration options available in this manifest, see the installation reference.
note

Before creating this manifest, read its contents and make sure its settings are correct for your environment. For example, if you have replaced pod-network-cidr you must change it in this file as well.

kubectl create -f https://raw.githubusercontent.com/projectcalico/calico/v3.29.1/manifests/custom-resources.yaml

Verify Calico installation​

You can verify Calico installation in your cluster by issuing the following command.

watch kubectl get pods -l k8s-app=calico-node -A

You should see a result similar to the below. Note that the namespace might be different, depending on the method you followed.

NAMESPACE     NAME                READY   STATUS    RESTARTS   AGE
kube-system   calico-node-2xcf4   1/1     Running   0          57s
kube-system   calico-node-gkqkg   1/1     Running   0          57s
kube-system   calico-node-j44hp   1/1     Running   0          57s

Use ctrl+c to break out of watch.

Congratulations you now have a Kind cluster equipped with Calico

Clean up​

Issuing a delete command will destroy the cluster that you created in this tutorial.

kind delete cluster --name dev

Next steps​

Required

Recommended tutorials