k3sup

k3sup is a light-weight utility to get from zero to KUBECONFIG with k3s on any local or remote VM.

Install k3sup using Homebrew:

brew install k3sup

NOTE:

Most commands in the following assume superuser privileges, so you may want to run them with sudo or switch to the root user (su)

Install k3s Master Node

Note: If there is an existing kubeconfig file from a previous installation, you may want to remove it first rm -f ~/.kube/config.

k3sup install \
    --user pi \
    --sudo true \
    --ip 192.168.1.11 \
    --cluster \
    --k3s-channel stable \
    --no-extras \
    --local-path ~/.kube/config \
    --merge \
    --tls-san 192.168.1.10 \
    --tls-san k3s.local.spaelling.xyz

validate that k3s is running

export KUBECONFIG=~/.kube/config
kubectl config use-context default
kubectl get node -o wide

and check the status of the k3s service

systemctl status k3s.service
cat /etc/systemd/system/k3s.service

Look specifically for --tls-san k3s.local.spaelling.xyz --tls-san 192.168.1.10 --disable servicelb --disable traefik. If any of these parameters are missing the installation did not go as planned.

If missing add to the k3s.service file and restart the service:

systemctl daemon-reload
systemctl restart k3s.service

Join a new server to the cluster

k3sup join \
    --user pi \
    --ip 192.168.1.12 \
    --sudo true \
    --server \
    --server-ip 192.168.1.11 \
    --server-user pi \
    --k3s-channel stable \
    --no-extras

Uninstall k3s

Simply run the uninstall script on each node:

sudo /usr/local/bin/k3s-uninstall.sh