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

Illustrazione: un uomo che festeggia davanti a una tastiera luminosa, circondato da icone di cloud e codice

🌐 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

  1. 🔑 Blinda SSH — porta personalizzata, autenticazione solo con chiave, configurazioni più strette
  2. 🔥 Costruisce regole firewall IPv4 + IPv6 con rilevamento dei port scan tramite xt_recent
  3. 🧱 Attiva SELinux in enforcing con i contesti giusti per i container
  4. ☸️ Installa K3s, Helm, cert-manager e nginx-ingress
  5. 📦 Distribuisce automaticamente l’intero stack di workload Kubernetes
  6. 📝 Configura WordPress tramite WP-CLI come un civilissimo goblin dell’automazione
  7. ☁️ Configura Nextcloud tramite occ, compresi Redis, SMTP e trusted domains
  8. 📈 Imposta gli exporter di monitoraggio + lo scraping di Prometheus + le dashboard di Grafana
  9. 🛡️ Distribuisce Fail2Ban, auditd, le scansioni di rkhunter e gli aggiornamenti di sicurezza automatici
  10. ☕ 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.yml
  • vars.yml
  • hosts.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_NAME

    Ora le credenziali richiedono un file .my.cnf montato.

    Ho anche scoperto che i permessi 0600 non aiutano se il container gira come nobody. 🤡

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

Alcuni testi e immagini di questo sito sono creati con l’aiuto dell’IA o generati dall’IA. Dettagli