This playbook will build an HA Kubernetes cluster with k3s, kube-vip and MetalLB via ansible.
This is based on the work from this fork which is based on the work from k3s-io/k3s-ansible. It uses kube-vip to create a load balancer for control plane, and metal-lb for its service LoadBalancer.
I have simple just rewrote the git as a role instead of a whole collection and renewed the code for Ansible 2.11 and later.
If you want more context on how this works, see:
📄 Documentation (including example commands)
Build a Kubernetes cluster using Ansible with k3s. The goal is easily install a HA Kubernetes cluster on machines running:
- Debian
- Ubuntu
- CentOS
on processor architecture:
- x64
- Deployment environment must have Ansible 2.11.0+
serverandagentnodes should have passwordless SSH access, if not you can supply arguments to provide credentials-ask-pass --ask-become-passto ach command.- Please see examples/example inventory/site/group_vars for example of needed group vars for this role.
Change the inventory.ini files to the hosts
Example:
[master]
192.168.30.38
192.168.30.39
192.168.30.40
[node]
192.168.30.41
192.168.30.42
[k3s_cluster:children]
master
nodeIf multiple hosts are in the master group, the playbook will automatically set up k3s in HA mode with etcd.
This requires at least k3s version 1.19.1 however the version is configurable by using the k3s_version variable.
If needed, you can also edit inventory/my-cluster/group_vars/all.yml to match your environment.
Start provisioning of the cluster using the following command:
ansible-playbook site.yml --ask-become-pass -i inventory/my-cluster/hosts.ini
After deployment control plane will be accessible via virtual ip-address which is defined in inventory/group_vars/all.yml as apiserver_endpoint
ansible-playbook reset.yml --ask-become-pass -i inventory/my-cluster/hosts.ini
To copy your kube config locally so that you can access your Kubernetes cluster run:
scp debian@master_ip:~/.kube/config ~/.kube/config
Thanks to these repos for code and ideas: