README.md

Setup

These are the steps required to deploy the nodes of the cluster

M910q nodes

Install the OS

• Download and flash a USB drive with Ubuntu Server 22.04 LTS
• Install Ubuntu
  • HDD with ext4 partition mounted at /
  • M.2 drive with ext4 partition mounted at /data
  • Pre-install microk8s and docker snap packages and enable OpenSSH server
  • Set the hostname cluster-node-x, username and password
• On first boot
  • Update and add packages:

sudo apt update
sudo apt upgrade --yes --fix-missing
sudo apt autoremove
sudo apt install fwupd jq net-tools vim

wget -O- https://carvel.dev/install.sh > install.sh
sudo bash install.sh
rm install.sh

• Add id_rsa.pub to ~/.ssh/authorized_keys

Set up Microk8s

sudo microk8s enable dns
sudo microk8s enable helm3
sudo microk8s enable hostpath-storage
sudo microk8s enable ingress

echo "alias kubectl='sudo microk8s kubectl'" >> ~/.bash_aliases
echo "alias helm='sudo microk8s helm3'" >> ~/.bash_aliases

Add nodes

On the main-node:

sudo microk8s add-node

On the new node:

sudo microk8s join ...

Raspberry Pi node

Install the OS

• Flash an SD card with a the Ubuntu Server 22.04 LTS ARM64 image
  • Use the Raspberry Pi Imager
  • Before writing, click the gear icon and:
  • Set the hostname
  • Enable SSH
  • Set the username and password
• On first boot:
  • Enable cgroups per MicroK8s instructions:
  • Update and add packages:

sudo apt update
sudo apt upgrade --yes --fix-missing
sudo apt autoremove

# avahi-daemon enables mDNS, which allows for cluster-node-#.local to be advertised
# linux-modules-extra-raspi is required for Calico to function properly (https://microk8s.io/docs/troubleshooting)
sudo apt install avahi-daemon jq linux-modules-extra-raspi net-tools vim

• Install Microk8s

sudo snap install microk8s --classic
echo "alias kubectl='sudo microk8s kubectl'" >> ~/.bash_aliases
echo "alias helm='sudo microk8s helm3'" >> ~/.bash_aliases

sudo microk8s join ...