Multi-worker cluster

This example shows how to use Kubitect to set up a Kubernetes cluster with one master and three worker nodes.

Note

In this example we skip the explanation of some common configurations (hosts, network, node template, ...), as they are already explained in the Getting started (step-by-step) guide.

Step 1: Cluster configuration

To create a cluster with multiple workers, simply specify multiple worker nodes in the configuration. In this particular case, we want to have 3 worker nodes, but there can be as many as you want.

multi-worker.yaml

cluster:
  ...
  nodes:
    master:
      instances:
        - id: 1
          ip: 192.168.113.10 # (1)!
    worker:
      instances:
        - id: 1
          ip: 192.168.113.21
        - id: 7
          ip: 192.168.113.27
        - id: 99

1. Static IP address of the node. If the ip property is omitted, the DHCP lease is requested when the cluster is created.

Final cluster configuration

multi-worker.yaml

hosts:
  - name: localhost
    connection:
      type: local

cluster:
  name: local-k8s-cluster
  network:
    mode: nat
    cidr: 192.168.113.0/24
  nodeTemplate:
    user: k8s
    updateOnBoot: true
    ssh:
      addToKnownHosts: true
    os:
      distro: ubuntu
  nodes:
    master:
      instances:
        - id: 1
          ip: 192.168.113.10
    worker:
      instances:
        - id: 1
          ip: 192.168.113.21
        - id: 7
          ip: 192.168.113.27
        - id: 99

kubernetes:
  version: v1.23.7
  networkPlugin: calico
  dnsMode: coredns
  kubespray:
    version: v2.19.0

Step 2: Applying the configuration

Apply the cluster:

kubitect apply --config multi-worker.yaml