Come abbinare le policy di riavvio di Docker a database, worker e app web

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

Scegli le policy di riavvio di Docker in base al ciclo di vita del servizio e alla semantica di uscita, invece di assegnare unless-stopped a ogni container in un file Compose.

Le policy di riavvio reagiscono quando termina il processo principale di un container; un controllo dello stato di salute può contrassegnare come non in buono stato un processo ancora in esecuzione senza riavviarlo automaticamente. Database, worker, applicazioni web, migrazioni e processi pianificati richiedono quindi scelte diverse, in base al fatto che debbano restare attivi, al significato di una terminazione regolare e a come debbano essere segnalati gli errori ripetuti.

Tieni separati il comportamento di riavvio, lo stato di salute e la disponibilità

Una policy di riavvio stabilisce se Docker debba avviare di nuovo un container dopo l'arresto del suo processo. Un controllo dello stato di salute stabilisce se il servizio in esecuzione è in grado di svolgere un'operazione definita. La verifica della disponibilità delle dipendenze stabilisce se un altro servizio debba già avviarsi. Sono problemi correlati, ma distinti.

Un articolo del 2026 spiega questa distinzione con controllo dello stato di salute e riavvio sono separati e mostra come le condizioni di stato di Compose possano ritardare l'avvio dei servizi dipendenti finché un servizio non è effettivamente pronto.

Non aspettarti che restart: always ripari un processo web non in buono stato che non termina mai, né che un controllo dello stato di salute, da solo, lo riavvii. In base alla progettazione del servizio, fai terminare l'applicazione quando proseguire non è sicuro, aggiungi un meccanismo esterno di ripristino oppure invia un avviso quando il servizio non è in buono stato.

Usa policy di riavvio persistenti per i database a esecuzione prolungata

Normalmente ci si aspetta che un database su un home server torni disponibile dopo il riavvio dell'host o del daemon Docker. unless-stopped è spesso una scelta predefinita pratica quando si vuole rispettare un arresto intenzionale da parte dell'amministratore; always è adatto quando, per scelta progettuale, il riavvio del sistema deve annullare tale arresto manuale.

Un articolo di luglio 2026 sul riavvio in base all'uscita del processo illustra le differenze tra no, on-failure, always e unless-stopped, compreso il fatto che la policy reagisce all'uscita del processo e non allo stato di salute.

Anche il database necessita di un vero controllo dello stato di salute e di uno storage durevole. Riavviare PostgreSQL ripetutamente non può risolvere un disco pieno, una configurazione non valida, uno stato corrotto o una migrazione incompatibile. Invia un avviso in caso di riavvii ripetuti, invece di considerarli un segno di resilienza efficace.

Scegli la policy del worker in base alla coda e alla semantica di uscita

Un worker di coda a esecuzione prolungata può richiedere unless-stopped se deve elaborare continuamente il lavoro. Un worker temporaneo o un processo batch può usare on-failure:N, così gli errori temporanei ricevono un numero limitato di tentativi, mentre un errore persistente causa un arresto visibile.

Un attuale numero limitato di tentativi di riavvio in caso di errore sottolinea che il comportamento dei riavvii dovrebbe dipendere dal fatto che un processo debba restare attivo a tempo indeterminato o possa terminare normalmente.

Scopri cosa significa il codice di uscita 0 per l'immagine del worker. Se significa «job completato», always può trasformare un job monouso completato in un ciclo infinito. Se invece il worker deve funzionare come daemon, un'uscita imprevista anche con esito positivo può comunque giustificare il riavvio automatico tramite unless-stopped.

Mantieni le app web attive a lungo, ma subordinane l'avvio alla disponibilità effettiva delle dipendenze

La maggior parte delle applicazioni web self-hosted è progettata per restare sempre disponibile, quindi in genere è più semplice interpretare unless-stopped che una policy limitata ai soli errori. L'impostazione di riavvio non elimina la necessità che database, cache, DNS, segreti e percorsi montati siano pronti.

La guida diagnostica correlata di ZimaSpace sui cicli di riavvio dei container dovuti alle dipendenze spiega perché riavviare ripetutamente l'app visibile può nascondere il problema che si è verificato per primo: un guasto del database, della cache, del mount, della migrazione o della memoria.

Usa i controlli di integrità delle dipendenze per definire l'ordine di avvio, quando opportuno, e limita i tentativi dell'applicazione. Un servizio web che va in crash ogni cinque secondi finché PostgreSQL non si avvia è meno monitorabile di uno che attende che sia pronto e si avvia una sola volta senza errori.

Assegna un ciclo di vita finito alle migrazioni e ai job monouso

I container di migrazione, gli strumenti di importazione, le attività di manutenzione e i job di inizializzazione eseguiti una sola volta non sono daemon ordinari. Spesso il loro stato di successo è «uscita con codice 0 e arresto». L'uso di always o unless-stopped può far ripetere involontariamente un'attività completata.

Mantieni espliciti gli strumenti operativi monouso, invece di lasciarli diventare servizi nascosti sempre attivi. Una migrazione o un'importazione dovrebbe avere uno stato di completamento definito, che resti visibile dopo l'uscita del comando.

Usa restart: "no" quando un guasto deve comportare un arresto per consentire l'ispezione, oppure una policy on-failure con tentativi limitati solo quando il comando può essere ripetuto in sicurezza. Per le migrazioni dello schema, verifica che sia possibile ripetere una migrazione applicata solo parzialmente prima di automatizzare i tentativi.

Verifica la policy con scenari di guasto reali

Per ogni servizio, verifica l'uscita regolare del processo, un crash con codice diverso da zero, il riavvio dell'host, il riavvio del daemon Docker, l'arresto manuale, la condizione di servizio non integro ma in esecuzione e l'indisponibilità di una dipendenza. Registra lo stato previsto dopo ogni evento prima di considerare resiliente la configurazione.

Monitora il numero di riavvii e invia un avviso quando supera una soglia bassa in un determinato intervallo di tempo. Il riavvio automatico dovrebbe ridurre i tempi di ripristino in caso di guasti transitori; non dovrebbe nascondere un crash persistente generando un flusso infinito di nuovi container.

Una buona matrice delle policy è esplicita: i database e le app web a lunga durata si riavviano dopo il riavvio dell'infrastruttura, i worker daemon si ripristinano in base alla semantica delle code, i job finiti si arrestano al completamento e i controlli di integrità e disponibilità segnalano i problemi che la policy di riavvio non può rilevare.

Assistenza e consigli

Altre letture

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.