Ubuntu 26.04 / Modificare i servizi con verifica e drop-in systemd

Per cambiare in modo controllato la configurazione di un servizio Ubuntu, registra i file originali e i valori effettivi, applica una modifica separata, validala e verifica il comportamento. Rileggere le unità systemd, ricaricare la configurazione dell’applicazione e riavviare il processo sono operazioni diverse.

Individuare l’unità originale e i drop-in

Un’unità systemd descrive una risorsa gestita, per esempio un servizio. Un drop-in è un file aggiuntivo che modifica alcune direttive senza riscrivere il file principale. Identifica il nome reale del servizio, quindi usa systemctl cat NOME_REALE.service e systemctl show NOME_REALE.service -p FragmentPath -p DropInPaths, sostituendo il segnaposto. Registra percorsi, contenuto e stato prima dell’intervento.

cat mostra i file sul disco: se sono stati modificati senza daemon-reload, possono differire dalla configurazione già caricata dal gestore. Conserva anche i valori pertinenti mostrati da systemctl show, lo stato e il risultato dell’ultima esecuzione. La guida alle unità e ai servizi systemd spiega questi controlli.

Non modificare direttamente il file del pacchetto sotto /usr/lib/systemd/system: un aggiornamento può sostituirlo. Per una personalizzazione locale usa il drop-in appropriato sotto /etc/systemd/system. I file .conf sono combinati secondo le regole di precedenza e l’ordine lessicografico: il numero nel nome non garantisce che il tuo valore sia quello finale. Controlla anche i drop-in generali del tipo service.d e quelli dei prefissi del nome. Il manuale systemd.unit di Ubuntu 26.04 descrive percorsi e precedenze.

Creare un servizio di laboratorio indipendente

Esegui l’esercizio nella console di una VM Ubuntu 26.04 dedicata, con un account autorizzato a usare sudo. Servono systemd come gestore del sistema, systemctl, systemd-analyze, journalctl e l’eseguibile /usr/bin/printenv. Non applicare il blocco a un’applicazione reale. Verifica che il nome ubuntu-course-lab.service sia libero nell’intero percorso di ricerca, comprese unità caricate, alias e directory drop-in. Se esiste già qualcosa con quel nome, fermati e scegli un nome distinto in tutti i percorsi e comandi.

Il blocco crea un file nuovo con set -C, cioè noclobber: la redirezione non deve sovrascrivere un file regolare esistente. È una protezione aggiuntiva, non una verifica della provenienza dei percorsi o dei collegamenti simbolici. Se la creazione fallisce non continuare manualmente con i comandi successivi. Il servizio stampa soltanto la variabile dimostrativa LAB_MODE e non viene abilitato all’avvio.

(
set -eu
sudo sh -c 'set -C; cat > /etc/systemd/system/ubuntu-course-lab.service' <<'EOF'
[Unit]
Description=Ubuntu course configuration lab

[Service]
Type=oneshot
Environment=LAB_MODE=baseline
ExecStart=/usr/bin/printenv LAB_MODE
EOF
sudo systemd-analyze verify /etc/systemd/system/ubuntu-course-lab.service
sudo systemctl daemon-reload
sudo systemctl start ubuntu-course-lab.service
journalctl -u ubuntu-course-lab.service --since '5 minutes ago' --no-pager
)

Controlla nel journal la nuova esecuzione e il valore baseline. Consulta anche systemctl show ubuntu-course-lab.service -p Result -p ExecMainStatus: un risultato riuscito e un codice di uscita zero sono distinti dal semplice stato attivo. Con Type=oneshot e senza RemainAfterExit=yes, questo comando termina e l’unità torna inattiva; non è di per sé un errore. Il manuale systemd.service descrive questo ciclo di vita.

La finestra di cinque minuti del journal può includere esecuzioni precedenti: annota l’istante di ogni avvio e confronta le righe nuove, non limitarti a trovare una vecchia riga baseline. Se non puoi leggere il journal, usa i privilegi autorizzati e verifica l’errore di accesso; un output vuoto non certifica il successo.

Cambiare un solo valore con un drop-in

Conserva una copia del file appena creato e del suo contenuto nel registro dell’esercizio. Verifica che non siano intervenute modifiche altrui e che 10-lab.conf non esista. Poi esegui il blocco completo: crea il drop-in, controlla l’unità, fa rileggere le definizioni e avvia di nuovo il servizio oneshot ormai inattivo.

(
set -eu
sudo mkdir -p /etc/systemd/system/ubuntu-course-lab.service.d
sudo sh -c 'set -C; cat > /etc/systemd/system/ubuntu-course-lab.service.d/10-lab.conf' <<'EOF'
[Service]
Environment=LAB_MODE=changed
EOF
sudo systemd-analyze verify /etc/systemd/system/ubuntu-course-lab.service
sudo systemctl daemon-reload
sudo systemctl start ubuntu-course-lab.service
journalctl -u ubuntu-course-lab.service --since '5 minutes ago' --no-pager
)

Il file principale conserva Environment=LAB_MODE=baseline; il drop-in assegna LAB_MODE=changed. Per questa direttiva, una successiva assegnazione alla stessa variabile sostituisce quella precedente: lo specifica il manuale systemd.exec sulla variabile Environment. Non estendere questa regola a tutte le direttive: alcune aggiungono elementi a liste e richiedono un azzeramento esplicito prima della sostituzione.

Confronta nuovamente systemctl cat ubuntu-course-lab.service, systemctl show ubuntu-course-lab.service -p Environment -p FragmentPath -p DropInPaths e il journal della nuova esecuzione. Il risultato atteso è LAB_MODE=changed nella proprietà pertinente e changed nell’output del nuovo avvio, con esito riuscito. Se trovi ancora baseline o un valore diverso, verifica precedenza, percorsi e successo di ogni passaggio prima di procedere.

systemd-analyze verify controlla le definizioni delle unità e segnala vari problemi, ma non dimostra che ogni impostazione dell’applicazione sia valida o che file, permessi e porte funzionino davvero. Leggi errori e avvisi secondo il manuale systemd-analyze. Se la verifica fallisce, il blocco si ferma prima di daemon-reload; il file appena creato resta sul disco e va ispezionato o rimosso in modo mirato.

Distinguere rilettura del gestore, reload e restart

Comando Effetto e limite
systemctl daemon-reload Fa rileggere al gestore systemd le unità e ricostruire le dipendenze. Non ricarica da solo la configurazione interna dell’applicazione e non cambia l’ambiente di un processo già avviato.
systemctl reload NOME.service Chiede al servizio di ricaricare la propria configurazione mediante il meccanismo supportato. Non tutti i servizi lo implementano; non sostituisce daemon-reload dopo una modifica all’unità.
systemctl restart NOME.service Arresta e avvia il servizio; se era fermo lo avvia. Può interrompere connessioni e attività: pianifica l’impatto e verifica il nuovo processo e il comportamento dell’applicazione.

La distinzione è documentata nel manuale systemctl di Ubuntu 26.04. Nel laboratorio usiamo start dopo ciascuna esecuzione conclusa: per un demone già attivo, start non implica il riavvio con i nuovi valori. Non usare reload-or-restart presumendo che eviti sempre interruzioni: quando reload non è supportato può riavviare il servizio.

Per esempio, la guida in inglese alla configurazione Nginx distingue il controllo nginx -t dalla sua applicazione. Dopo una modifica reale valida prima con lo strumento dell’applicazione, scegli reload o restart in base al supporto e alla finestra di intervento, quindi prova una nuova connessione e la risposta attesa. Un comando terminato senza errore non prova da solo che il servizio risponda correttamente agli utenti.

Ripristinare soltanto la modifica dell’esercizio

Prima di rimuovere il drop-in, ricontrolla che sia esattamente il file creato da te e che nessuno lo abbia modificato nel frattempo. Salva il contenuto e confrontalo con il registro. Il blocco seguente rimuove esclusivamente quel file; non eseguirlo su una configurazione preesistente o condivisa.

(
set -eu
sudo rm -- /etc/systemd/system/ubuntu-course-lab.service.d/10-lab.conf
sudo systemctl daemon-reload
sudo systemctl start ubuntu-course-lab.service
journalctl -u ubuntu-course-lab.service --since '5 minutes ago' --no-pager
)

Ricontrolla i file, la proprietà Environment, il risultato dell’avvio e le nuove righe del journal. In questo laboratorio isolato devi ritrovare baseline. Se un altro drop-in prevale, l’assenza di 10-lab.conf non garantisce da sola il valore: indaga senza cancellare le personalizzazioni altrui. Se uno dei passaggi fallisce, registra quale ha fallito e ispeziona lo stato corrente prima di riprovare.

systemctl revert può eliminare più personalizzazioni locali dell’unità e non è adatto a togliere solo questa modifica. Se vuoi anche pulire il servizio di prova, verifica che non abbia esecuzioni o job in corso e che file e directory appartengano soltanto all’esercizio; rimuovi esclusivamente il file dell’unità creato da te, la directory drop-in solo se vuota, poi esegui daemon-reload. Non cancellare ricorsivamente directory di configurazione. Per un’applicazione reale ripristinare un file non basta: occorre validare, applicare con il meccanismo corretto e ripetere le prove di funzionamento.