Skip to content

Latest commit

 

History

History
50 lines (45 loc) · 2.46 KB

setupArm64RaspberryPiK3OSAgent.md

File metadata and controls

50 lines (45 loc) · 2.46 KB

Set up an ARM64 Raspberry Pi 4 cluster node

  1. Download the ubuntu 18.04.x TLS 64-bit image for Raspberry Pi 4

  2. Uncompress the image and flash to a micro SD card

  3. Boot the pi

  4. ssh into the system user ubuntu and password ubuntu, you will be prompted to change the password, so enter a new password. You will be disconnected, so ssh in again using the new password

  5. Update ubuntu sudo apt update && sudo apt upgrade -y

  6. create config file config.yaml. You can look at the configuration reference for additional configuration options:

    cat <<EOF | tee config.yaml
ssh_authorized_keys:
- ssh-rsa AAAAB3NzaC1yc2EAAAADAQ...
hostname: bi-k3os-rpi1
k3os:
  data_sources:
  - cdrom
  dns_nameservers:
  - 192.168.201.1
  - 192.168.0.4
  ntp_servers:
  - 0.uk.pool.ntp.org
  - 1.europe.pool.ntp.org
  password: password
  server_url: https://SERVER:6443
  token: TOKEN_VALUE
  labels:
    plan.upgrade.cattle.io/k3os-latest: enabled
EOF

Where:

  • WORKSTATION_SSH_PUBLIC_KEY is your ssh public key, on linux/mac this is stored in ~/.ssh/id_rsa.pub. It should start with something similar to ssh-rsa AAAAB3NzaC1
  • PASSWORD is the password you want to assign to the rancher user - this is not going to be used as you use the ssh key when login to the system
  • SERVER is the hostname or IP address of the master node of the cluster
  • TOKEN_VALUE is the token from file /var/lib/rancher/k3s/server/node-token on the master node. SSH into the master node and enter command sudo cat /var/lib/rancher/k3s/server/node-token to display it cat / You may also want to change the hostname

  1. Edit file nobtcmd.txt to enable cgroups needed for containers: sudo vi /boot/firmware/nobtcmd.txt and add cgroup_memory=1 cgroup_enable=memory to the end of the first line. There should only be a single line of content in this file.
    Note: It is important that you do this step and reboot before booting the overlay, otherwise the cmdline.txt file is not used once the overlay takes over

  2. Reboot to make the kernel command line changes active sudo reboot

  3. Overlay K3OS and add the config then reboot into K3OS

    curl -sfL https://github.com/rancher/k3os/releases/download/v0.10.0/k3os-rootfs-arm64.tar.gz | sudo tar zxvf - --strip-components=1 -C /
sudo cp config.yaml /k3os/system/config.yaml
sync
sudo reboot