Een jaar later: eindelijk mijn homelab-K3s-stack open source gemaakt

🌐 Ook in: English · Deutsch · Français · Español · Italiano · Português · Polski
In een paar van mijn recente posts zei ik al dat ik probeerde uit te zoeken hoe ik de automatiseringscode van mijn homelab kon publiceren *zonder per ongeluk mijn hele infrastructuur mee open source te maken* 😅
Dat blijkt een verrassend niet-triviaal probleem te zijn als je Ansible-inventory eruitziet als een cyberpunk-schatkist vol vaults, secrets en hostspecifieke variabelen. 🔐🐉
Na wat proberen, falen, cafeïne en twijfelachtige levenskeuzes… vond ik eindelijk een opzet die prachtig werkt:
👉 twee aparte git-remotes.
Een private, zelfgehoste Gitea-instantie bewaart de *echte* repository — inclusief versleutelde secrets, vaultbestanden en alle pittige interne stukjes.
Ondertussen krijgt een publieke GitHub-repo alleen de schone automatiseringscode, met gevoelige bestanden uitgesloten via .gitignore en vervangen door vriendelijke .example-templates. 🧼✨
Alles wat geheim is, wordt sowieso versleuteld met Ansible Vault (AES-256) — dus zelfs als er toch iets doorheen glipt, krijgt een aanvaller alleen versleuteld wartaal. 🧠💾
📦 Repo:
👉 github.com/aptupgrademe/www_k3s
Het project zet Nextcloud of WordPress op een vers single-node K3s-cluster op AlmaLinux 9.
Eén commando.
Nul click-ops.
Maximale nerd-energie. ⚡🤓
Inhoud
🧠 Het idee
Draai:
ansible-playbook blog.yml --limit <host> --ask-vault-pass
…tegen een gloednieuwe VPS en kijk hoe die zichzelf transformeert tot een volledig geharde, TLS-enabled, gemonitorde WordPress- of Nextcloud-server, als een soort Pokémon-evolutie voor infrastructuur. 🐛➡️🐉
Geen handmatig gepruts via SSH.
Geen mysterieuze setupstappen.
Geen kerkhof van “TODO: later documenteren”. 💀
Alles is idempotent — draai het wanneer je wilt opnieuw zonder je data op te blazen of configuration-drift-demonen op te roepen.
⚙️ De stack in één oogopslag
- 🏗️ K3s — Kubernetes zonder het enterprise-trauma
- 🔀 F5 nginx-ingress — draait als DaemonSet met
hostNetwork: true - 🔒 cert-manager — automatische Let’s Encrypt-certificaten, want browsers smachten naar groene slotjes
- 📝 WordPress 6.9-fpm + nginx-sidecar + MariaDB 10.11
- ☁️ Nextcloud 33-fpm + Redis + Collabora CODE voor zelfgehoste kantoorvibes op nerdniveau
- 📊 Prometheus + Grafana — want als je er geen grafiek van kunt maken, bestaat het dan wel?
- 🛡️ iptables — standaard DROP, portscandetectie, ICMP-rate-limiting, een kleine digitale slotgracht 🏰
- 🔐 Fail2Ban, auditd, rkhunter, dnf-automatic — paranoia as code™
🚀 Wat één playbookrun echt doet
- 🔑 Hardt SSH — eigen poort, alleen key-authenticatie, strakkere configs
- 🔥 Bouwt IPv4- en IPv6-firewallregels met portscandetectie via
xt_recent - 🧱 Zet SELinux op enforcing met de juiste containercontexten
- ☸️ Installeert K3s, Helm, cert-manager en nginx-ingress
- 📦 Rolt automatisch de volledige Kubernetes-workloadstack uit
- 📝 Configureert WordPress via WP-CLI als een beschaafde automatiseringsgoblin
- ☁️ Configureert Nextcloud via
occ, inclusief Redis, SMTP en trusted domains - 📈 Zet monitoring-exporters + Prometheus-scraping + Grafana-dashboards op
- 🛡️ Rolt Fail2Ban, auditd, rkhunter-scans en automatische security-updates uit
- ☕ Verbruikt waarschijnlijk minder koffie dan ik tijdens het debuggen
🔐 Secrets & security
Alle credentials worden versleuteld met Ansible Vault (AES-256).
Gevoelige bestanden zoals:
vault.ymlvars.ymlhosts.yml
…komen nooit in de publieke repository. 🚫🌍
De GitHub-repo bevat alleen herbruikbare automatiseringscode en .example-templates:
vars.yml.example
vault.yml.example
hosts.yml.example
Clonen → waarden invullen → versleutelen → deployen. ✨
🙃 Dingen die veel moeilijker waren dan verwacht
Let’s Encrypt HTTP-01-challenge gaf 301 terug
Blijkt dat alles naar HTTPS redirecten ook de ACME-challenge redirect. Wie had dat kunnen denken? 🙃
Opgelost met F5 Mergeable Ingresses (master/minion-patroon), zodat
/.well-known/de redirects omzeilt.Oneindige HTTPS-redirectloop
Mijn eerste nginx-logica deed in feite een filosofische DDoS op zichzelf.
Opgelost met een schoner redirectpatroon met drie variabelen.
mysqld_exporter v0.19.0 schafte
DATA_SOURCE_NAMEafCredentials hebben nu een gemount
.my.cnf-bestand nodig.Ook ontdekt dat
0600-rechten niet helpen als de container alsnobodydraait. 🤡iptables OUTPUT DROP sloopte de interne werking van K3s
Want blijkbaar praat Kubernetes graag de hele tijd met zichzelf.
Opgelost met expliciete ACCEPT-regels voor de pod-/service-CIDR’s.
Grafana-dashboard 1860 toonde “No data”
Moderne Grafana-dashboards bevatten geen
__inputsmeer.Oplossing: een piepklein Python-patchscript dat met de Grafana-API praat als een kleine automatiseringsgoblin.
🧪 Probeer het zelf
git clone https://github.com/aptupgrademe/www_k3s.git
cd www_k3s
cp inventory/hosts.yml.example inventory/hosts.yml
cp inventory/host_vars/test/vars.yml.example inventory/host_vars/myhost/vars.yml
# fill in your values, then:
ansible-vault encrypt inventory/host_vars/myhost/vault.yml
ansible-playbook blog.yml --limit myhost --ask-vault-pass
De volledige quickstart, het overzicht van de roles en de documentatie van de variabelen staan in de GitHub-README.
PR’s, feedback en mede-infrastructuurnerds zijn welkom. 🚀🐧☸️
