Multi Node k3s cluster

In the example below we will use a bare metal host to provision a Kairos cluster in the local network with K3s and one master node.

Installation

Use the standard images which contain k3s.

Follow the Installation documentation, and use the following cloud config file with Kairos for the master and worker:

• server
• worker

#cloud-config

hostname: metal-{{ trunc 4 .MachineID }}
users:
- name: kairos
  # Change to your pass here
  passwd: kairos
  ssh_authorized_keys:
  # Replace with your github user and un-comment the line below:
  # - github:mudler

k3s:
  enabled: true
  args:
  - --disable=traefik,servicelb

#cloud-config

hostname: metal-{{ trunc 4 .MachineID }}
users:
- name: kairos
  # Change to your pass here
  passwd: kairos
  ssh_authorized_keys:
  # Add your github user here!
  - github:mudler

k3s-agent:
  enabled: true
  env:
   K3S_TOKEN: ...
   K3S_URL: ...

Deploy first the server; the value to use for K3S_TOKEN in the worker is stored at /var/lib/rancher/k3s/server/node-token on your server node.

Notably:

• we use the k3s block to disable traefik and servicelb (the default k3s load balancer)
• You can add additional configuration as args to k3s here, see k3s documentation