Como identificar que dependência do contentor está a causar um ciclo de reinícios

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.

Identifique a primeira dependência que fica indisponível antes de a aplicação sair, em vez de tratar todos os contentores que reiniciam como a causa principal.

Numa pilha do Docker Compose, a aplicação visível pode entrar num ciclo de reinícios porque uma base de dados ainda está a arrancar, o Redis está inacessível, o DNS devolve o serviço errado, falta uma montagem de ligação, um segredo foi alterado, uma migração falhou ou a aplicação foi terminada devido à pressão da memória. O diagnóstico mais rápido regista a primeira saída e o erro da dependência, interrompe os reinícios automáticos e testa cada serviço necessário com a mesma rede e as mesmas credenciais usadas pelo contentor com falhas.

Encontre o Primeiro Contentor que Falha, Não o que Faz Mais Barulho

Para cada serviço da pilha, indique o número de reinícios, o estado atual, o estado de saúde, o último código de saída e a hora de início. Ordene a cronologia para que a primeira falha apareça antes de os contentores secundários começarem a tentar restabelecer a ligação ou a reiniciar.

O guia da Netdata sobre ciclos de reinício mostra como os códigos e estados de saída permitem distinguir encerramentos por OOM, falhas de segmentação, terminações normais e paragens relacionadas com o estado de saúde. Um sinal OOMKilled ou de código de saída pode dispensar a investigação de dependências quando, na realidade, a aplicação está a ficar sem memória ou a falhar internamente.

Se uma dependência falhar primeiro, investigue-a antes da aplicação. Se a aplicação sair primeiro com erros de ligação recusada, tempo limite, autenticação ou ficheiro em falta, associe essa mensagem à dependência exata que tentou utilizar.

Interrompa o Ciclo de Reinícios e Registe uma Falha Limpa

Desative temporariamente ou substitua a política de reinício do serviço afetado e execute-o uma vez em primeiro plano ou consulte os registos completos de uma única tentativa de arranque. Preserve os carimbos de data/hora do daemon do Docker e de cada dependência.

Os reinícios automáticos repetidos podem sobrepor o primeiro erro relevante com falhas de ligação posteriores. Um contentor que reinicia a cada poucos segundos também pode sobrecarregar a base de dados, o resolvedor de DNS ou o volume de registos e criar sintomas secundários.

Não elimine contentores, volumes ou bases de dados durante esta recolha. Pare apenas o ciclo de reinícios, reproduza o problema uma vez e guarde o ambiente, as montagens, as ligações de rede, o comando e o estado de saída antes de alterar a configuração.

Mapeie Todas as Dependências de que o Contentor Precisa para Ficar Pronto

Anote a base de dados, a cache, a fila de mensagens, o armazenamento de objetos, o resolvedor de DNS, o fornecedor de identidade, os ficheiros montados, os segredos e as APIs externas de que a aplicação precisa. Inclua o nome de serviço, a porta, o protocolo, o nome de utilizador, a base de dados e o caminho esperados.

O Dash0 explica que a ordem de arranque do Compose não significa automaticamente que o processo dentro de uma dependência esteja pronto; uma aplicação pode arrancar enquanto o Postgres ainda está a inicializar. A solução é aguardar pelo estado saudável de uma dependência, em vez de simplesmente pelo seu estado em execução.

Classifique as dependências como obrigatórias ou opcionais. A indisponibilidade de um serviço opcional de métricas não deve reiniciar a aplicação principal, enquanto a indisponibilidade de uma base de dados pode exigir uma espera controlada, uma nova tentativa ou a paragem.

Teste cada dependência a partir da rede do contentor com falhas

Use um contentor de diagnóstico temporário ligado à mesma rede ou abra uma shell compatível antes de a aplicação terminar. Teste, por esta ordem, o DNS do nome do serviço, a porta TCP, o TLS, a autenticação, uma consulta à base de dados e o caminho necessário.

O guia da Last9 sobre verificações de estado do Compose refere que as verificações de prontidão impedem o arranque dos serviços dependentes até os componentes críticos conseguirem responder efetivamente. Uma verificação útil valida a operação do serviço de que os clientes precisam, em vez de apenas confirmar que existe um processo.

Se o DNS falhar, verifique a pertença à rede e os aliases. Se a ligação TCP for estabelecida, mas a autenticação falhar, compare os segredos e os utilizadores. Se o início de sessão funcionar, mas faltar o esquema, o bucket, a fila ou o diretório esperado, corrija a inicialização em vez da rede.

Verifique os pontos de montagem, os segredos e as migrações enquanto dependências

Compare os pontos de montagem vinculados atuais, os volumes nomeados, as permissões, a propriedade, os ficheiros de ambiente, os ficheiros de segredos e a versão da aplicação com a última implementação funcional. Um contentor pode aceder à base de dados e, ainda assim, reiniciar porque um ficheiro de configuração é só de leitura ou uma migração não consegue escrever.

Um caso de estudo sobre o arranque de contentores mostra que uma ordem de dependências baseada no estado pode impedir que uma aplicação falhe antes de a base de dados estar pronta. A sequência de arranque condicional torna-se especialmente importante durante o primeiro arranque e as migrações.

Execute as migrações uma vez, com os registos visíveis, e faça uma cópia de segurança da base de dados antes de repetir etapas destrutivas. Se a versão da aplicação tiver mudado, confirme que a versão da dependência e o percurso de atualização do esquema são compatíveis.

Reative os serviços pela ordem das dependências e valide a estabilidade

Inicie primeiro a dependência de nível mais baixo, aguarde pela verificação de estado efetiva, inicie depois a camada seguinte e, por fim, a aplicação. Registe as contagens de reinícios e as alterações de estado durante vários intervalos de verificação.

O guia da ZimaSpace sobre falhas de DNS no contentor aborda um caminho de dependência que só pode surgir dentro do ambiente da aplicação.

O problema só fica resolvido quando a aplicação arranca uma vez, todas as dependências obrigatórias se mantêm operacionais, as migrações são concluídas e um reinício deliberado de uma dependência desencadeia uma nova tentativa controlada ou uma recuperação, em vez de outro ciclo. Só reative uma política de reinício depois de a causa raiz poder ser observada e estar limitada.

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.