Skip to main content

Install KubeMaya

In your edge device run the following steps:

  1. Set your WLAN location before start (sudo raspi-config Localisation Options > WLAN Country)
  2. Set a temporary WIFI Connection with nmtui
sudo mount /dev/sda1 /mnt
  1. Copy the file to the edge device (Mount a USB Device)
cp /mnt/k3s_airgapped_installer.tgz .
  1. Or copy the .tgz using scp using ssh
/bin/bash kubemaya.sh scp_device <IP_ADDRESS> <USER>
  1. Untar the file in /opt/k3s:
sudo mkdir -p /opt/k3s
sudo tar -xzvf k3s_airgapped_installer.tgz -C /opt/k3s
  1. Install missing dependencies (Tested in Rasbian minimal)
sudo /bin/bash /opt/k3s/scripts/kubemaya.sh install-dep
  1. Set the flags to use containers in your device by running(Raspberry only):
/bin/bash /opt/k3s/scripts/kubemaya.sh set-flags

Note: This restarts your device, also for Debian you have to set the following flag systemd.unified_cgroup_hierarchy=1 in the variable GRUB_CMDLINE_LINUX_DEFAULT inside the file /etc/default/grub and restart your device.
8. Disable your current wifi-connection if set (nmtui in Raspbian)
9. Change to the installer path

cd /opt/k3s
  1. Install K3s running:
sudo /bin/bash scripts/kubemaya.sh k3s-install

Note: To override to a different architecture than arm64, use the variable K3S_ARCH=<amd64,etc>.

sudo K3S_ARCH=SOME_VALUE /bin/bash scripts/kubemaya.sh k3s-install

Cleaning previous installation​

To clean a previous installation run the following commands

  1. To uninstall K3s run:
k3s-uninstall.sh
  1. Delete the /opt/k3s directory:
rm -R /opt/k3s

Testing your installation​

Listing container images in the installation:

sudo ctr containers list

Run the following commands in the device to install nginx:

kubectl create deploy nginx --image=nginx:1.17.5-alpine
kubectl expose deploy nginx --port=80
kubectl create ingress nginx --rule=/=nginx:80

Access the nginx in http://192.168.0.100 in the device that is connected to the new MAYABOX Network

Here is a video of how this looks to install KubeMaya: asciicast

For setup swap memory: https://www.digitalocean.com/community/tutorials/how-to-add-swap-space-on-ubuntu-20-04