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

Illustrazione: un uomo che festeggia il primo anniversario con fuochi d’artificio e loghi tecnologici

🌐 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 push li 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:

  1. ⚙️ Configura l’inventario e le variabili degli host
  2. 🔐 Cifra il tuo vault con Ansible Vault
  3. 📦 Installa le collection Ansible richieste
  4. 🚀 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

👉

Scarica www_k3s.zip

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. 😄

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