dotfiles-server

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.

🔄 Start from scratch

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.

☸️ Deploy our Kubernetes 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.yml

You 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 password

This will create a fully functional cluster with MetalLB and kube-vip.

🔥 Reset our Kubernetes cluster

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.yml

🚀 Deploy and reset services

You can find the playbooks and documentation for each service in their respective folders.

Credits

This repository Kubernetes cluster was inspired by https://github.com/techno-tim/k3s-ansible