git log –since=”1 year ago”: un anno di apt-upgrade.me && pubblico i playbook Ansible per Nextcloud su K3s

🌐 Anche in: English · Deutsch · Français · Español · Português · Nederlands · Polski
In ogni percorso da homelab arriva il momento in cui guardi la tua pila di
script bash, file di configurazione fatti a mano e post-it con scritto cose tipo
“ricordati di fare chown su /data prima di avviare” — e decidi:
basta. 😅
Questo è quel post. Oggi pubblico i playbook Ansible che uso per installare
e gestire Nextcloud ☁️ e WordPress 📝 su un
cluster K3s a nodo singolo che gira su AlmaLinux 9.
Tutto è infrastructure-as-code, completamente idempotente,
e viene fornito con una guida operativa completa.
Ma prima, una breve parola dai nostri sponsor — e con questo intendo:
un momento di autoriflessione involontaria. 🙂
🎉 Box laterale: aspetta, questo blog ha un compleanno?
Ieri è passato esattamente un anno da quando il primissimo post è andato online su questo blog.
Conteneva esattamente due parole: Hallo Welt.
Che in tedesco significa Hello World,
che in linguaggio da programmatore significa:
“Non ho la minima idea di cosa sto facendo, ma ho un dominio, una VPS,
e per
git pushli userò entrambi." 🚀Sinceramente non mi aspettavo che questo blog esistesse ancora un anno dopo.
La maggior parte dei miei progetti collaterali segue un ciclo di vita molto prevedibile:
git init→ esplosione di entusiasmo → tre commit →
git stash→ dimenticato per sempre 💀Eppure eccoci a un anno di uptime, che in termini di progetti personali
equivale più o meno a un’azienda della Fortune 500 che festeggia il suo centenario.
Le metriche sono di conseguenza impressionanti:
- 📚 diversi post
- 👀 almeno due lettori (uno dei quali sono io che controllo il layout mobile)
- 📈 una dashboard Grafana che nessuno a parte me ha mai guardato
Obiettivo sbloccato. 🏆
Torniamo ora al vero argomento di questo post.
Indice
🚀 Cosa fa questo repository
Il codice che pubblico oggi è un toolkit infrastrutturale basato su Ansible
che installa e gestisce workload su un
cluster K3s a nodo singolo che gira su AlmaLinux 9:
☁️ Nextcloud — sincronizzazione file e collaborazione self-hosted,
incluso Collabora CODE per modificare documenti office online
📝 WordPress — esattamente per il tipo di blog che stai leggendo adesso
Entrambi gli stack condividono un insieme comune di ruoli Ansible che coprono:
hardening di SSH 🔐,
regole del firewall 🛡️,
monitoraggio 📊,
relay della posta,
aggiornamenti di sicurezza automatici,
scansione dei rootkit,
e audit logging.
I playbook sono progettati per essere idempotenti:
puoi eseguirli ripetutamente su un sistema in produzione e cambiano solo ciò che
va davvero cambiato. ✨
L’intera infrastruttura è descritta nel codice.
Non ci sono passaggi manuali nascosti sepolti in un quaderno da qualche parte.
Se il server va a fuoco (in senso figurato — è una VPS 😄),
se ne può allestire uno nuovo da zero con un singolo
comando ansible-playbook e un ripristino dal backup.
☸️ Architettura: Nextcloud su K3s
La decisione di progetto centrale è un cluster Kubernetes a nodo singolo con K3s.
Niente alta disponibilità. Niente setup multi-master. Niente cluster etcd.
Solo un server, un nodo, un singolo punto di guasto — intenzionalmente.
Per questo tipo di workload, la semplicità operativa vale molto di più che fingere
di gestire un hyperscaler in un homelab. 🙂
K3s ci dà comunque tutte le belle funzionalità di Kubernetes:
- ⚙️ manifest dichiarativi
- 🔄 rolling deployment
- 🔐 cert-manager
- 🌍 ingress controller
...senza l’overhead operativo.
🛡️ Sicurezza: difesa in profondità
Il modello di sicurezza è a strati. Nessun singolo meccanismo è considerato affidabile da solo.
Lo stack combina invece più controlli indipendenti:
- 🔥 iptables con policy predefinite DROP
- 🔐 configurazione SSH irrobustita
- 🚫 Fail2Ban contro il brute force
- ⚡ rate limiting di nginx
- 🧩 SELinux in modalità enforcing
- 🔑 segreti cifrati con Ansible Vault
- 🕵️ monitoraggio con auditd + rkhunter
- 📦 aggiornamenti di sicurezza automatici
O, detto altrimenti:
difesa in profondità, non
“spero che nessuno scansioni questa VPS.” 😄
📊 Monitoraggio: Prometheus + Grafana
Il monitoraggio è completamente automatizzato con:
Prometheus 📈,
Grafana 📊,
Node Exporter,
mysqld_exporter,
e metriche di PHP-FPM.
Le dashboard vengono importate e configurate automaticamente dal playbook,
tra cui:
- 📈 Node Exporter Full
- 🗄️ MySQL Overview
- ⚡ metriche PHP-FPM
Perché se proprio devi sovraingegnerizzare un homelab,
tanto vale avere bei grafici che mostrano esattamente quanto è sovraingegnerizzato. 🙂
💾 Backup e ripristino
Il repository include veri script di backup e ripristino —
non solo sensazioni ottimistiche e una cartella chiamata
backup_final_v2_REAL. 😅
I backup coprono:
- 🗄️ dump di MariaDB
- 📂 file dell’applicazione Nextcloud
- ☁️ dati degli utenti
- 🔄 automazione del ripristino
Dopo un ripristino, rieseguire il playbook garantisce che tutta la configurazione e
le impostazioni dell’applicazione tornino automaticamente nello stato previsto.
🚀 Per iniziare
Il repository è pensato per un’installazione nuova di AlmaLinux 9.
Il processo di setup è volutamente semplice:
- ⚙️ Configura l’inventario e le variabili degli host
- 🔐 Cifra il tuo vault con Ansible Vault
- 📦 Installa le collection Ansible richieste
- 🚀 Esegui il playbook
Il deployment è completamente idempotente, il che significa che le modifiche future —
che siano aggiornamenti delle immagini, ritocchi al firewall o app aggiuntive —
si possono distribuire semplicemente eseguendo di nuovo il playbook.
📥 Download
L’intero repository è disponibile come archivio ZIP.
Estrailo, compila i tuoi host_vars,
cifra il vault e sei pronto per il deployment:
unzip www_k3s.zip
cd www_k3s
ansible-galaxy collection install -r requirements.yml
ansible-vault encrypt inventory/host_vars/<host>/vault.yml
ansible-playbook nextcloud-k3s.yml --limit <host> --ask-vault-pass
👉
Licenza MIT, nessuna garanzia – controllalo tu stesso prima di usarlo.
Domande, problemi o suggerimenti? 💬
Lasciali nei commenti qui sotto.
Piccola nota: non ho ancora deciso del tutto come voglio pubblicare e mantenere il codice per bene tramite GitLab, quindi per ora lo stato attuale è fornito come semplice archivio ZIP 📦. A lungo termine potrei spostare tutto su GitHub o un altro repository pubblico, ma è ancora un dibattito infrastrutturale aperto tra me, il mio tempo libero e diverse liste di TODO incompiute. 😄
