This is a collection of Ansible playbooks to deploy a Kubernetes cluster as well as run various services. I'm currently running them in my homelab. This repository contains the following services:
- Atuin (Shell history manager)
- PiHole & Unbound (Local recursive DNS with blocking capabilities)
- Git (Local git server to host personal stuff e.g. Obsidian notes)
- Immich (Local photo storage & more)
- Wireguard (VPN)
The Kubernetes cluster is configured with MetalLB (Flannel by default), kube-vip & etcd.
You can follow the wiki to get started from no OS to a fully functionnal cluster with services. If you already have a server running Linux you can just deploy the cluster.
First, clone this repository locally and edit the hosts.ini file with the IPs of your infrastructure. Next, edit the
files global_vars.yml & K3s/vars.yml to configure your Kuberbenetes cluster according to your environment. Then, run the following command to install all of Ansible's requirements
ansible-galaxy collection install -r requirements.ymlYou might have to install netaddr on your local machine as well.
Finally, deploy your cluster by running
ansible-playbook -k -K -e @global_vars.yml -e @K3s/vars.yml -i hosts.ini K3s/playbook-site.yml # Remove -k -K if no SSH passwordThis will create a fully functional cluster with MetalLB and kube-vip.
Simply run the following playbook to remove Kubernetes and your services from your infrastructure
ansible-playbook -k -K -e @global_vars.yml -e @K3s/vars.yml -i hosts.ini K3s/playbook-reset.ymlYou can find the playbooks and documentation for each service in their respective folders.
This repository Kubernetes cluster was inspired by https://github.com/techno-tim/k3s-ansible