k8s-raspberry-pi

Automated Installation and Configuration of Kubernetes (K8s) on Raspberry Pi

Prerequisites

• Raspberry Pi boards with a minimum of 2 GiB RAM, preconfigured with Ubuntu (20.04) and connected to your network
  • Here's a handy walkthrough, from Canonical: How to install Ubuntu Server on your Raspberry Pi
• Ansible 2.5.x >= 2.9.x

Notes

• Tested using MacOS Big Sur as the Ansible control machine, with Python 3.9
• This may work with other versions of Ubuntu, but I have only tested on Ubuntu 20.04.2 LTS
• I defaulted to Flannel as the CNI plugin, but you can override this with the pod_network_yaml variable when running the kube_cluster_config.yml playbook

Directions

1. Clone this repository to your computer
2. Update inventory/hosts with any changes you'd like to make to node names and IPs for your Raspberry Pis
3. Run the installation playbook, overriding any variables specified in vars, if you need to

   ansible-playbook -i inventory kube_cluster_install.yml -v
   

4. Run the configuration playbook, which will initialize the control plane and join nodes to the cluster

   ansible-playbook -i inventory kube_cluster_config.yml -v
   

5. Verify that the cluster is healthy

   ansible-playbook -i inventory kube_cluster_verify.yml -v
   

Special Thanks

The Ansible playbooks were based on these posts:

• Installing Kubernetes on Raspberry Pi
• Build a Kubernetes cluster with the Raspberry Pi