Porque é que um proxy inverso devolve 502 após a reconstrução de um contentor?

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 proxy inverso devolve 502 após a recriação de um contentor quando deixa de conseguir estabelecer uma ligação válida ao destino upstream recriado.

A recriação pode substituir o contentor, atribuir-lhe um novo endereço, desligar ou renomear uma rede Docker, alterar a porta exposta, repor uma configuração incompleta ou iniciar o proxy antes de a aplicação estar pronta. O diagnóstico correto começa pelo registo de erros do proxy e segue o endereço upstream exato do proxy até ao contentor, em vez de reiniciar ambos os serviços até o erro desaparecer temporariamente.

Confirme que o 502 é causado por uma falha na ligação upstream

Aceda uma vez ao domínio afetado e registe a data e hora, o estado do proxy, o endereço upstream e a mensagem de erro completa. Distinga entre ligação recusada, anfitrião não encontrado, tempo limite excedido, ligação reposta, falha no handshake TLS e resposta inválida.

Um 502 significa que o proxy não recebeu uma resposta upstream utilizável, mas o detalhe do erro determina se o destino não existia, estava inacessível, não estava a escutar ou usava o protocolo errado. Um guia atual de resolução de problemas do NGINX refere que um contentor recriado pode deixar o proxy a usar um endereço de backend antigo até a resolução de nomes ou a configuração serem atualizadas.

Teste a aplicação diretamente a partir do anfitrião ou do contentor do proxy, usando o nome ou endereço upstream, a porta e o protocolo indicados no registo. Se esse pedido direto falhar da mesma forma, continue a investigação entre o proxy e o contentor, em vez de alterar o DNS público ou os certificados.

Compare o destino upstream antes e depois da recriação

Inspecione o nome do contentor recriado, o nome do serviço, o IP interno, a porta exposta, a porta publicada, os aliases de rede e as redes associadas. Compare-os com a configuração do proxy e com o último destino que funcionou.

Um problema do nginx-proxy descreve uma recriação que alterou o IP do contentor da aplicação, enquanto o proxy continuou a enviar pedidos para o destino upstream inacessível do contentor. O domínio público manteve-se correto, tendo mudado apenas a identidade do destino upstream privado.

Prefira um nome de serviço do Compose ou um alias de rede estável em vez de um IP de contentor. Se o IP for intencionalmente fixo, verifique se o serviço recriado o recebeu efetivamente e se nenhum outro contentor passou a usar esse endereço.

Verifique se o proxy e a aplicação continuam a partilhar uma rede Docker

Liste as redes associadas ao proxy e à aplicação e confirme que partilham pelo menos uma rede definida pelo utilizador. A publicação de uma porta no anfitrião não torna automaticamente o nome do contentor acessível a partir de outra rede Docker isolada.

Um caso de rede Docker revelou que transferir um serviço dependente para a rede adequada eliminou imediatamente as respostas 502 recorrentes, demonstrando como um percurso para o serviço a montante inacessível pode causar problemas mesmo quando todos os contentores continuam em execução.

Ligue os serviços através do Compose, em vez de usar comandos pontuais, para que a relação se mantenha após as reconstruções. Teste a resolução DNS e a porta do serviço a montante a partir do contentor do proxy depois de recriar a pilha.

Verifique a porta interna de escuta e o endereço de ligação

Confirme que a aplicação está à escuta na porta usada pelo proxy e num endereço acessível a partir da rede do contentor. Não confunda uma porta publicada no anfitrião com a porta interna em que o contentor está à escuta.

O proxy só consegue estabelecer ligação depois de a aplicação aceitar ligações para além do loopback. Um serviço que esteja à escuta em 127.0.0.1 dentro do próprio contentor não está disponível para o proxy, mesmo que um comando de verificação de saúde local seja bem-sucedido.

Inspecione o registo da aplicação, a lista de sockets e um pedido direto a partir do contentor do proxy. Se a porta recusar ligações, corrija o listener ou a configuração da aplicação antes de adicionar tentativas ou aumentar os tempos limite do proxy.

Aguarde até a aplicação estar pronta em vez de se basear no arranque do contentor

Um contentor reconstruído pode estar em execução enquanto as migrações, a recuperação da base de dados, o aquecimento da cache ou a geração da configuração ainda impedem a aplicação de aceitar pedidos. Compare a hora do primeiro erro 502 com o estado de saúde e os registos de arranque.

Uma discussão sobre a resolução de problemas do Grist mostra como a arquitetura do Docker, as definições do ambiente e a disponibilidade do serviço a montante podem combinar-se e provocar falhas 502 no lado do contentor persistentes após uma reconstrução.

Adicione uma verificação de saúde significativa e faça com que o proxy ou os serviços dependentes aguardem pela operação de que os clientes precisam, não apenas pela existência de um processo. Limite as tentativas para que uma aplicação com falhas permanentes não pareça estar apenas a arrancar lentamente.

Atualize a resolução do proxy e reconstrua o percurso estável

Recarregue ou recrie o proxy depois de o nome do serviço, a rede, a porta e o estado de saúde estarem corretos. Se o proxy só resolver nomes no arranque, configure a resolução em tempo de execução suportada ou uma ordem de reinício previsível.

O fluxo de trabalho do ZimaSpace para isolar uma dependência de contentor com falhas fornece o diagnóstico complementar quando o serviço a montante termina repetidamente em vez de permanecer saudável.

A reparação só está concluída quando o proxy resolve o nome do serviço após outra reconstrução, acede à porta interna pretendida, aguarda durante o arranque e disponibiliza o domínio sem edições manuais de IP. Remova os destinos temporários de IP direto e as ligações de rede não documentadas após a validação.

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.