Um contentor pode continuar a ser utilizável enquanto a verificação de estado falha, porque a sondagem testa um comando, endereço, utilizador ou condição de prontidão diferente do percurso usado pelo navegador.
Num servidor doméstico, a aplicação pode abrir através de um proxy inverso, mesmo que o Docker execute o comando de verificação de estado dentro do contentor contra localhost, um utilitário em falta, a porta errada ou uma dependência temporariamente indisponível. Comece por reproduzir a sondagem exata dentro do contentor e, em seguida, compare o respetivo destino e resultado esperado com o percurso real do utilizador, antes de aumentar o número de tentativas ou desativar a verificação de estado.
Compare o que o navegador testa com o que a verificação de estado testa
Registe o URL e o percurso de rede que permitem aceder à aplicação. Anote se o navegador passa por um proxy inverso, uma porta publicada no anfitrião, um IP local ou acede diretamente ao contentor.
O Docker executa a sondagem configurada dentro do contentor, pelo que pode testar um endpoint diferente do navegador. Um caso da comunidade Docker mostrou que uma verificação de estado falhou porque a imagem não continha o comando curl usado pela sondagem, embora o processo do serviço pudesse continuar em execução.
Se o percurso pelo qual o navegador acede à aplicação passar por outro proxy ou porta, não considere esse resultado prova de que o destino da sondagem interna está correto. Registe ambos os percursos e identifique o primeiro componente que difere.
Execute o comando exato de verificação de estado no contentor
Copie exatamente o comando de verificação de estado, incluindo o formato shell, o URL, as opções, as credenciais e as variáveis de ambiente. Execute-o no contentor em execução como o mesmo utilizador e registe o código de saída e o resultado.
Um contentor marcado como não saudável pode continuar a ter um processo em execução, porque o estado de saúde reflete o resultado da sondagem e não se os utilizadores conseguem carregar uma página. O fluxo de diagnóstico do Netdata distingue falhas na sondagem de falhas no processo antes de alterar o comportamento de reinício.
Se o comando for bem-sucedido manualmente, compare o utilizador de execução, a shell, o diretório de trabalho, o ambiente e a temporização usados pela verificação automática. Se falhar manualmente, o erro identifica agora a camada seguinte, sem ter de esperar por outro intervalo de verificação de estado.
Verifique a ferramenta de sondagem, a shell, o PATH e o utilizador
Confirme que todos os executáveis do comando de verificação de estado existem na imagem atual e podem ser executados pelo utilizador do contentor. As imagens mínimas podem não incluir curl, wget, bash, ferramentas de DNS ou arquivos de certificados.
As sondagens no formato shell e exec comportam-se de forma diferente. As aspas, os pipes, a expansão de variáveis e os comandos compostos requerem uma shell disponível, enquanto um comando direto precisa do caminho completo para o executável quando o ambiente da verificação de estado tem um PATH limitado.
Execute o comando com um caminho absoluto e o utilizador de serviço pretendido. Corrija a imagem ou a verificação em vez de instalar ferramentas de forma interativa, pois uma alteração manual no contentor desaparece na compilação seguinte.
Verifique o endereço interno, a porta e o protocolo
Inspecione o serviço de escuta da aplicação dentro do contentor e compare-o com o URL da verificação. Uma porta do anfitrião publicada, como 8080:80, não significa que o serviço escute na porta 8080 dentro do contentor.
As verificações de estado devem testar o estado da aplicação controlado pelo contentor. O guia prático da Dash0 indica que uma verificação pode chamar um endpoint HTTP ou inspecionar um processo, mas o endpoint tem de refletir o estado real de prontidão do contentor, e não uma rota disponível apenas através de um proxy externo.
Teste 127.0.0.1, o endereço de escuta do contentor e o nome do serviço apenas quando for adequado. Se a aplicação só estiver ligada a um socket Unix ou a outra interface, altere a verificação para usar o ponto de entrada interno real.
Distinga um arranque lento de uma falha permanente
Meça o tempo que a aplicação, a migração da base de dados, o aquecimento da cache ou o carregamento do modelo demoram a responder no endpoint correto. Compare esse tempo com start_period, interval, timeout e retries.
O Compose pode bloquear serviços dependentes quando uma dependência continua marcada como não saudável, mesmo que fique pronta mais tarde. Uma regressão do Compose reportada mostrou um serviço a ficar saudável só depois de a falha da dependência já ter parado a pilha, revelando uma janela de arranque da verificação de estado demasiado curta.
Aumente os tempos apenas quando os registos confirmarem que a aplicação está a progredir normalmente. Mais tentativas não devem ocultar uma porta errada, uma migração falhada, um certificado em falta ou uma base de dados inacessível.
Mantenha a verificação específica e confirme a recuperação
Decida se a verificação de estado deve representar a atividade do processo, a prontidão da aplicação local ou uma cadeia de dependências mais profunda. Não marque um contentor local como não saudável apenas porque uma API externa opcional está indisponível.
O guia do ZimaSpace para encontrar a primeira dependência que falhou é o próximo passo quando a própria aplicação não consegue ficar pronta sem uma base de dados, uma cache ou um serviço de rede.
O problema fica resolvido quando a verificação automática exata é bem-sucedida após o arranque normal, o contentor se mantém saudável durante os reinícios das dependências e o fluxo de trabalho real da aplicação continua disponível. Mantenha a verificação suficientemente rigorosa para detetar um serviço avariado, mas suficientemente específica para evitar falhas falsas causadas por sistemas não relacionados.
Assistência e dicas
Mais para ler

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



