Automatizzare il proprio homelab: primi script per manutenzione e controllo
Un homelab Linux può iniziare con una semplice macchina virtuale e crescere, nel tempo, fino a comprendere server, container Docker, servizi di rete e applicazioni che utilizziamo ogni giorno. Quando i componenti aumentano, però, diventa importante sapere come stanno funzionando e accorgersi dei problemi prima che diventino difficili da individuare.
Non dobbiamo necessariamente installare una piattaforma di monitoraggio complessa. Per iniziare possiamo costruire piccoli strumenti che raccolgono informazioni, controllano lo stato del sistema e ci restituiscono un rapporto leggibile.
In questo articolo realizzeremo uno script di manutenzione per Linux, adatto a un server domestico o a una macchina virtuale. Lo script non modificherà la configurazione e non eseguirà operazioni distruttive: si limiterà a raccogliere alcune informazioni utili per i nostri controlli periodici.
È un primo passo concreto per trasformare il nostro homelab in un ambiente più ordinato, comprensibile e semplice da gestire.
Quali controlli automatizzare per primi?
Quando amministriamo un server domestico, alcune informazioni meritano di essere controllate con regolarità . Lo spazio disponibile sui dischi, per esempio, può diminuire a causa dei log, dei backup o dei dati prodotti dalle applicazioni. La memoria RAM può diventare insufficiente se avviamo troppi servizi, mentre un servizio che si è arrestato potrebbe lasciare inaccessibile una parte del nostro laboratorio.
Possiamo raccogliere queste informazioni utilizzando strumenti già presenti nella maggior parte delle distribuzioni Linux:
dfper controllare lo spazio disponibile sui filesystem;freeper osservare l’utilizzo della memoria;uptimeper conoscere il tempo trascorso dall’ultimo avvio e il carico del sistema;systemctlper verificare lo stato dei servizi gestiti da systemd.
Questi comandi non sostituiscono un sistema di monitoraggio continuo, ma sono sufficienti per realizzare un primo rapporto di manutenzione.
Se non abbiamo ancora un homelab dedicato, possiamo svolgere gli esperimenti anche su una macchina virtuale Linux. È preferibile imparare a conoscere gli strumenti su un ambiente di prova prima di applicarli a un server che ospita dati o servizi importanti.
Creiamo il nostro script di controllo
Per tenere ordinato il lavoro, creiamo una directory dedicata agli script personali:
mkdir -p ~/homelab-tools
cd ~/homelab-tools
Apriamo un editor di testo e creiamo un file chiamato controllo-homelab.sh. Inseriamo questo contenuto:
#!/usr/bin/env bash
set -u
RAPPORTO="${1:-rapporto-homelab.txt}"
{
echo "=================================="
echo " RAPPORTO DI CONTROLLO HOMELAB"
echo "=================================="
echo "Data: $(date '+%Y-%m-%d %H:%M:%S')"
echo "Host: $(hostname)"
echo
echo "--- Tempo di attività e carico ---"
uptime
echo
echo "--- Spazio sui filesystem ---"
df -h
echo
echo "--- Memoria ---"
free -h
echo
echo "--- Servizi systemd non riusciti ---"
systemctl --failed --no-pager || true
echo
} > "$RAPPORTO" 2>&1
printf 'Rapporto salvato in: %s\n' "$RAPPORTO"
Il programma raccoglie le informazioni e le scrive in un unico file di testo. La data e il nome della macchina ci aiutano a capire a quale sistema e a quale momento si riferisce il rapporto.
La variabile RAPPORTO permette anche di scegliere il nome del file al momento dell’esecuzione. Se non specifichiamo nulla, verrà creato rapporto-homelab.txt. La redirezione > "$RAPPORTO" raccoglie l’output nel file, mentre 2>&1 permette di includere anche eventuali messaggi di errore.
Abbiamo utilizzato set -u per intercettare l’uso di variabili non definite. Il comando systemctl --failed mostra invece le unità che systemd considera in stato di errore; non significa necessariamente che ogni servizio elencato sia un problema grave, perché alcuni servizi possono essere opzionali o non utilizzati.
Un dettaglio importante: il rapporto viene riscritto a ogni esecuzione. In questo modo non accumuliamo indefinitamente informazioni obsolete nello stesso file. Se vogliamo conservare lo storico, possiamo utilizzare un nome diverso per ogni esecuzione o predisporre in seguito una gestione delle copie.
Eseguiamo lo script e interpretiamo il rapporto
Prima di avviarlo, rendiamo eseguibile il file e lanciamolo:
chmod +x controllo-homelab.sh
./controllo-homelab.sh
Al termine vedremo un messaggio che indica dove è stato salvato il rapporto. Possiamo leggerlo con:
less rapporto-homelab.txt
Se preferiamo utilizzare un nome diverso, possiamo passarlo come argomento:
./controllo-homelab.sh controllo-server.txt
A questo punto abbiamo raccolto in un solo documento informazioni che normalmente avremmo dovuto cercare eseguendo più comandi.
Non dobbiamo però limitarci a guardare il rapporto come se fosse un semaforo automatico. Se df -h mostra un filesystem quasi pieno, dobbiamo capire quali dati stanno occupando spazio. Se systemctl --failed elenca un’unità , possiamo approfondirla con systemctl status nome-unità e consultare i messaggi disponibili nel journal.
L’obiettivo dello script è aiutarci a individuare dove guardare, non decidere al posto nostro quale intervento eseguire.
Controlliamo più macchine del nostro homelab
Se il laboratorio comprende più server, possiamo eseguire lo stesso controllo su ciascuna macchina. Per esempio, potremmo avere una macchina virtuale dedicata ai servizi web e un altro sistema utilizzato per gli esperimenti.
Una possibilità è collegarsi tramite SSH ed eseguire lo script sul server remoto, dopo averlo copiato nella directory desiderata. Se l’accesso è configurato correttamente, un comando di questo tipo permette di avviare il controllo su una macchina chiamata server-lab:
ssh utente@server-lab \
'bash -s' < controllo-homelab.sh
In questo esempio il contenuto dello script viene inviato alla shell remota tramite SSH. Il rapporto viene quindi prodotto sul terminale della sessione remota e restituito nella connessione. Per conservare un rapporto locale per ciascuna macchina, dovremo adattare lo script o la procedura di esecuzione in modo da salvare separatamente l’output.
Naturalmente, utente e server-lab sono valori di esempio: dobbiamo sostituirli con un account autorizzato e con il nome host o l’indirizzo del nostro server.
Prima di automatizzare controlli remoti, verifichiamo che SSH funzioni correttamente e che l’utente abbia i permessi necessari. Non è necessario eseguire tutto come amministratore: per molti controlli di base, un normale utente è sufficiente.
Pianificare il controllo senza complicare il sistema
Una volta verificato che lo script funziona, possiamo decidere di eseguirlo periodicamente. Per cominciare, però, è meglio avviarlo manualmente per qualche giorno e verificare che il rapporto sia utile e che non generi risultati fuorvianti.
Quando saremo pronti, Linux offre diversi strumenti per pianificare un’attività . Nei sistemi basati su systemd possiamo utilizzare un Timer associato a un servizio; in alternativa, possiamo ricorrere a cron. La scelta dipende dall’ambiente e da quanto vogliamo integrare l’automazione con il sistema.
È importante considerare anche dove vengono salvati i rapporti e per quanto tempo vogliamo conservarli. Se lo script viene eseguito ogni giorno e produce sempre un file con un nome fisso, il rapporto precedente verrà sovrascritto. Se invece vogliamo uno storico, dovremo prevedere nomi distinti, una rotazione o una procedura di archiviazione.
Per un laboratorio personale non serve progettare subito una soluzione sofisticata. È sufficiente partire da un controllo affidabile e aggiungere complessità soltanto quando emerge una necessità reale.
Dallo script alla manutenzione consapevole
Abbiamo costruito un piccolo strumento che raccoglie informazioni sul sistema e le organizza in un rapporto. È un esempio semplice, ma rappresenta bene il valore dell’automazione: ridurre le operazioni ripetitive e rendere più facile accorgersi dei cambiamenti.
Il passo successivo potrebbe essere aggiungere controlli mirati, come una segnalazione quando lo spazio disponibile scende sotto una soglia scelta da noi, oppure un rapporto dedicato ai container Docker. Prima di introdurre notifiche automatiche o interventi correttivi, conviene però stabilire con chiarezza quali condizioni costituiscono davvero un problema.
Un buon homelab non è necessariamente quello con più servizi o più strumenti. È quello che conosciamo, sappiamo controllare e possiamo ripristinare quando qualcosa non va come previsto.
Con piccoli script, controlli regolari e una gestione prudente delle modifiche, possiamo costruire nel tempo un ambiente sempre più affidabile, senza perdere di vista la cosa più importante: capire ciò che il nostro sistema sta facendo.
LICENZA E CONDIZIONI D’USO
Questo How-to è rilasciato sotto licenza Creative Commons Attribution-NonCommercial 3.0 Italy.Â
CONTATTI DELL’AUTORE
Marco Ciammella marco@orvietolinux.it
Orvieto Linux User Group info@orvietolinux.it