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

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...



