Un anno dopo: finalmente ho reso open source il mio stack K3s dell'homelab

🌐 Anche in: English · Deutsch · Français · Español · Português · Nederlands · Polski
In alcuni dei miei post recenti avevo detto che stavo cercando di capire come pubblicare il codice di automazione del mio homelab *senza rendere open source per sbaglio, insieme a lui, tutta la mia infrastruttura* 😅
A quanto pare è un problema sorprendentemente non banale quando il tuo inventory Ansible sembra uno scrigno cyberpunk pieno di vault, segreti e variabili specifiche per host. 🔐🐉
Dopo un po’ di tentativi, errori, caffeina e scelte di vita discutibili… finalmente ho trovato un setup che funziona alla grande:
👉 due remote git separati.
Un’istanza Gitea privata self-hosted custodisce il repository *vero* — compresi segreti cifrati, file vault e tutti i pezzi interni più piccanti.
Nel frattempo un repo GitHub pubblico riceve solo il codice di automazione pulito, con i file sensibili esclusi tramite .gitignore e sostituiti da simpatici template .example. 🧼✨
Tutto ciò che è segreto è comunque cifrato con Ansible Vault (AES-256) — quindi anche se per qualche motivo qualcosa sfuggisse, un attaccante otterrebbe solo un guazzabuglio cifrato. 🧠💾
📦 Repo:
👉 github.com/aptupgrademe/www_k3s
Il progetto installa Nextcloud oppure WordPress su un nuovo cluster K3s a nodo singolo che gira su AlmaLinux 9.
Un comando.
Zero click-ops.
Massima energia nerd. ⚡🤓
Indice
🧠 L’idea
Esegui:
ansible-playbook blog.yml --limit <host> --ask-vault-pass
…su una VPS appena creata e guardala trasformarsi in un server WordPress o Nextcloud completamente blindato, con TLS e monitoraggio, come una specie di evoluzione Pokémon dell’infrastruttura. 🐛➡️🐉
Niente armeggi manuali via SSH.
Niente passaggi di setup misteriosi.
Nessun cimitero di “TODO: documentare più tardi”. 💀
Tutto è idempotente — rilancialo quando vuoi senza distruggere i tuoi dati o evocare i demoni del configuration drift.
⚙️ Lo stack in breve
- 🏗️ K3s — Kubernetes senza il trauma enterprise
- 🔀 F5 nginx-ingress — gira come DaemonSet con
hostNetwork: true - 🔒 cert-manager — certificati Let’s Encrypt automatici, perché i browser bramano lucchetti verdi
- 📝 WordPress 6.9-fpm + sidecar nginx + MariaDB 10.11
- ☁️ Nextcloud 33-fpm + Redis + Collabora CODE per un ufficio self-hosted di livello nerd
- 📊 Prometheus + Grafana — perché se non puoi farne un grafico, esiste davvero?
- 🛡️ iptables — default DROP, rilevamento dei port scan, rate limiting ICMP, un minuscolo fossato digitale 🏰
- 🔐 Fail2Ban, auditd, rkhunter, dnf-automatic — paranoia as code™
🚀 Cosa fa davvero un run del playbook
- 🔑 Blinda SSH — porta personalizzata, autenticazione solo con chiave, configurazioni più strette
- 🔥 Costruisce regole firewall IPv4 + IPv6 con rilevamento dei port scan tramite
xt_recent - 🧱 Attiva SELinux in enforcing con i contesti giusti per i container
- ☸️ Installa K3s, Helm, cert-manager e nginx-ingress
- 📦 Distribuisce automaticamente l’intero stack di workload Kubernetes
- 📝 Configura WordPress tramite WP-CLI come un civilissimo goblin dell’automazione
- ☁️ Configura Nextcloud tramite
occ, compresi Redis, SMTP e trusted domains - 📈 Imposta gli exporter di monitoraggio + lo scraping di Prometheus + le dashboard di Grafana
- 🛡️ Distribuisce Fail2Ban, auditd, le scansioni di rkhunter e gli aggiornamenti di sicurezza automatici
- ☕ Probabilmente consuma meno caffè di quanto ne abbia consumato io facendone il debug
🔐 Segreti & sicurezza
Tutte le credenziali sono cifrate con Ansible Vault (AES-256).
File sensibili come:
vault.ymlvars.ymlhosts.yml
…non toccano mai il repository pubblico. 🚫🌍
Il repo GitHub contiene solo codice di automazione riutilizzabile e template .example:
vars.yml.example
vault.yml.example
hosts.yml.example
Clona → compila i valori → cifra → distribuisci. ✨
🙃 Cose che sono state molto più difficili del previsto
La challenge HTTP-01 di Let’s Encrypt restituiva 301
A quanto pare reindirizzare tutto su HTTPS reindirizza anche la challenge ACME. Chi l’avrebbe mai detto? 🙃
Risolto con i Mergeable Ingress di F5 (pattern master/minion), così
/.well-known/evita i redirect.Loop infinito di redirect HTTPS
La mia prima logica nginx in pratica si è autoinflitta un DDoS filosofico.
Risolto con un pattern di redirect più pulito a tre variabili.
mysqld_exporter v0.19.0 ha eliminato
DATA_SOURCE_NAMEOra le credenziali richiedono un file
.my.cnfmontato.Ho anche scoperto che i permessi
0600non aiutano se il container gira comenobody. 🤡iptables OUTPUT DROP ha rotto gli interni di K3s
Perché a quanto pare a Kubernetes piace parlare continuamente con se stesso.
Risolto con regole ACCEPT esplicite per i CIDR di pod e service.
La dashboard Grafana 1860 mostrava “No data”
Le dashboard Grafana moderne non contengono più
__inputs.Soluzione: un minuscolo script Python di patch che parla con l’API di Grafana come un piccolo goblin dell’automazione.
🧪 Provalo tu stesso
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
Il quickstart completo, la panoramica dei ruoli e la documentazione delle variabili si trovano nel README su GitHub.
PR, feedback e colleghi nerd dell’infrastruttura sono i benvenuti. 🚀🐧☸️
