Perché un controllo dello stato di un container fallisce mentre l’app continua ad aprirsi?

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.

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

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.