Porque é que a verificação de saúde de um contentor falha, enquanto a aplicação continua a abrir?

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

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

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.