Un container può restare utilizzabile anche se il controllo di stato non riesce, perché la sonda verifica un comando, un indirizzo, un utente o una condizione di disponibilità diversi dal percorso usato dal browser.
Su un home server, l'app potrebbe aprirsi tramite un reverse proxy anche se Docker esegue il comando di controllo dello stato all'interno del container usando localhost, un'utilità mancante, la porta sbagliata o una dipendenza temporaneamente non disponibile. Inizia riproducendo la sonda esatta all'interno del container, poi confrontane la destinazione e il risultato atteso con il percorso reale dell'utente prima di aumentare i tentativi o disattivare il controllo di stato.
Confronta ciò che verifica il browser con ciò che verifica il controllo di stato
Registra l'URL e il percorso di rete che consentono di aprire correttamente l'applicazione. Indica se il browser raggiunge un reverse proxy, una porta dell'host pubblicata, un IP locale o direttamente il container.
Docker esegue la sonda configurata all'interno del container, quindi potrebbe verificare un endpoint diverso da quello del browser. Un caso segnalato nella community di Docker ha mostrato un controllo di stato non riuscito perché nell'immagine mancava il comando curl usato dalla sonda, anche se il processo del servizio poteva comunque essere in esecuzione.
Se il percorso del browser che funziona passa attraverso un altro proxy o una porta diversa, non considerare questo risultato una prova che la destinazione interna della sonda sia corretta. Annota entrambi i percorsi e individua il primo componente che differisce.
Esegui il comando esatto per il controllo dello stato all'interno del container
Copia esattamente il comando di controllo dello stato, inclusi il formato shell, l'URL, le opzioni, le credenziali e le variabili d'ambiente. Eseguilo all'interno del container in esecuzione con lo stesso utente e registra il codice di uscita e l'output.
Un container contrassegnato come non integro può comunque avere un processo in esecuzione, perché lo stato di integrità riflette il risultato della sonda, non la possibilità per gli utenti di caricare una pagina. La procedura diagnostica di Netdata distingue un errore della sonda da un errore del processo prima di modificare il comportamento di riavvio.
Se il comando riesce manualmente, confronta l'utente di esecuzione, la shell, la directory di lavoro, l'ambiente e la tempistica usati dal controllo automatico. Se non riesce manualmente, l'errore ora indica il livello successivo da verificare, senza dover attendere un altro intervallo del controllo di stato.
Verifica lo strumento della sonda, la shell, PATH e l'utente
Verifica che ogni eseguibile nel comando di controllo dello stato sia presente nell'immagine corrente e possa essere eseguito dall'utente del container. Nelle immagini minimali potrebbero mancare curl, wget, bash, gli strumenti DNS o gli archivi di certificati.
Le sonde in formato shell e in formato exec si comportano diversamente. Per virgolette, pipe, espansione delle variabili e comandi composti è necessaria una shell disponibile, mentre un comando diretto richiede il percorso completo dell'eseguibile quando l'ambiente del controllo di stato ha un PATH limitato.
Esegui il comando con un percorso assoluto e l’utente previsto per il servizio. Correggi l’immagine o il controllo anziché installare strumenti manualmente, perché una modifica apportata al container scompare alla ricompilazione successiva.
Verifica l’indirizzo interno, la porta e il protocollo
Esamina il listener dell’applicazione all’interno del container e confrontalo con l’URL del controllo. Una porta host pubblicata come 8080:80 non significa che il servizio sia in ascolto sulla porta 8080 all’interno del container.
I controlli dello stato dovrebbero verificare lo stato dell’applicazione gestito dal container. La guida pratica di Dash0 spiega che un controllo può chiamare un endpoint HTTP o ispezionare un processo, ma l’endpoint deve riflettere l’effettivo stato di disponibilità del container, non una route accessibile solo tramite un proxy esterno.
Verifica 127.0.0.1, l’indirizzo di ascolto del container e il nome del servizio solo quando appropriato. Se l’app è in ascolto solo su un socket Unix o su un’altra interfaccia, modifica il controllo per usare il vero punto di ingresso interno.
Distingui l’avvio lento da un errore permanente
Misura quanto impiegano l’applicazione, la migrazione del database, il riscaldamento della cache o il caricamento del modello prima che l’endpoint corretto risponda. Confronta il tempo con start_period, interval, timeout e retries.
Compose può bloccare i servizi dipendenti quando una dipendenza risulta ancora non funzionante, anche se diventa pronta in seguito. Una regressione segnalata in Compose ha mostrato un servizio diventare funzionante solo dopo che il fallimento della dipendenza aveva già arrestato lo stack, mettendo in luce una finestra di avvio troppo ristretta per il controllo dello stato.
Aumenta i tempi solo quando i log dimostrano che l’app sta procedendo normalmente. Tempi di attesa più lunghi non devono nascondere una porta errata, una migrazione non riuscita, un certificato mancante o un database irraggiungibile.
Mantieni il controllo mirato e verifica il ripristino
Decidi se il controllo dello stato deve indicare che il processo è attivo, che l’applicazione locale è pronta o che è pronta una catena di dipendenze più ampia. Non contrassegnare come non funzionante un container locale solo perché un’API esterna facoltativa non è disponibile.
La guida di ZimaSpace per individuare la prima dipendenza che non funziona è il passo successivo quando l’applicazione non può diventare pronta senza un database, una cache o un servizio di rete.
Il problema è risolto quando il controllo automatico esatto riesce dopo l’avvio normale, il container rimane in salute durante i riavvii delle dipendenze e il flusso di lavoro reale dell’app continua a essere disponibile. Mantieni il controllo abbastanza rigoroso da rilevare un servizio non funzionante, ma sufficientemente mirato da evitare falsi errori dovuti a sistemi non correlati.
Assistenza e consigli
Altre letture

Come tenere nascosti i video per adulti sul tuo NAS ai tuoi familiari
Tieni privati i video per adulti su un NAS familiare. Controlla le autorizzazioni delle cartelle, l’accesso alle librerie di Plex e Jellyfin, le miniature,...

Cosa controllare prima di caricare un modello della community in Transformers
Usa l’aggiornamento della sandbox Jinja di Transformers per esaminare la provenienza dei modelli, i template di chat, il codice remoto, i pesi serializzati e...

Esegui Mirage in locale: OCR e rilevamento degli oggetti da una sola immagine
Prova il piccolo modello di visione locale di Cactus Compute, verifica l’OCR e l’estrazione degli oggetti con input reali e comprendi i limiti di...



