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

Illustratie: een man die juicht achter een gloeiend toetsenbord, omringd door cloud- en code-iconen

🌐 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

  1. 🔑 Hardt SSH — eigen poort, alleen key-authenticatie, strakkere configs
  2. 🔥 Bouwt IPv4- en IPv6-firewallregels met portscandetectie via xt_recent
  3. 🧱 Zet SELinux op enforcing met de juiste containercontexten
  4. ☸️ Installeert K3s, Helm, cert-manager en nginx-ingress
  5. 📦 Rolt automatisch de volledige Kubernetes-workloadstack uit
  6. 📝 Configureert WordPress via WP-CLI als een beschaafde automatiseringsgoblin
  7. ☁️ Configureert Nextcloud via occ, inclusief Redis, SMTP en trusted domains
  8. 📈 Zet monitoring-exporters + Prometheus-scraping + Grafana-dashboards op
  9. 🛡️ Rolt Fail2Ban, auditd, rkhunter-scans en automatische security-updates uit
  10. ☕ Verbruikt waarschijnlijk minder koffie dan ik tijdens het debuggen

🔐 Secrets & security

Alle credentials worden versleuteld met Ansible Vault (AES-256).

Gevoelige bestanden zoals:

  • vault.yml
  • vars.yml
  • hosts.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_NAME af

    Credentials hebben nu een gemount .my.cnf-bestand nodig.

    Ook ontdekt dat 0600-rechten niet helpen als de container als nobody draait. 🤡

  • 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 __inputs meer.

    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. 🚀🐧☸️

Sommige teksten en afbeeldingen op deze site zijn met hulp van AI gemaakt of door AI gegenereerd. Details