Um alias do Compose pode deixar de ser resolvido após a recriação se o serviço se ligar a uma rede diferente, associada ao projeto, ou se o alias deixar de estar ligado a essa rede.
Os aliases do Docker estão associados a redes, não são nomes globais. Recriar uma stack num novo diretório, com um nome de projeto explícito, um nome de stack do Portainer ou um projeto Compose pode criar uma nova rede predefinida, enquanto outra aplicação continua na antiga. O serviço pode estar saudável e acessível através da porta publicada, mas o seu alias interno falha porque o cliente e o destino já não partilham a mesma rede ou porque um proxy inverso selecionou uma ligação diferente.
Compare os nomes antigos e novos dos projetos Compose
Registe o nome do projeto anterior e o atual, o diretório de trabalho, o nome da stack, os nomes das redes e as etiquetas dos contentores. Compare os serviços cliente e destino após recriar a stack.
O Docker Compose usa o nome do projeto para agrupar e nomear recursos. A precedência do nome do projeto explica por que razão a alteração do diretório ou do nome da implementação pode criar uma rede nova em vez de reutilizar a antiga rede do projeto.
Se o cliente continuar ligado a oldproject_default enquanto o destino se liga a newproject_default, o alias anterior não terá um âmbito DNS partilhado.
Verifique o alias na rede partilhada exata
Inspecione ambos os contentores e liste todas as redes ligadas, os endpoints, os endereços IPv4 ou IPv6 e os aliases. Teste o DNS a partir do interior do contentor cliente.
A especificação do Compose define os aliases como nomes associados a uma rede, pelo que um alias declarado numa rede não existe automaticamente noutra rede à qual o serviço esteja ligado.
Mova a declaração do alias para a rede efetivamente partilhada pelos serviços. Não use container_name como substituto para uma descoberta de serviços devidamente configurada.
Verifique os nomes das redes externas e a substituição durante a implementação
Compare a chave lógica da rede Compose com o name externo explícito. Verifique a substituição de variáveis de ambiente e as variáveis da interface da stack utilizadas durante a implementação.
A documentação do Portainer indica que as stacks podem usar redes Docker existentes, que têm de ser selecionadas de forma consistente quando stacks implementadas de forma independente precisam de resolver os nomes umas das outras.
Uma rede externa impede alterações do prefixo do projeto apenas quando todas as stacks referenciam o mesmo nome de rede efetivo. Um erro de escrita pode criar ou selecionar uma rede diferente sem alterar a porta publicada pelo serviço.
Confirme que o cliente usa o DNS do Docker, e não um endereço em cache
Execute uma nova consulta a partir do cliente, inspecione a configuração do resolvedor e reinicie apenas o processo que faz a cache do DNS, se necessário. Compare a resolução de nomes com a consulta direta pelo nome do serviço.
O modelo de espaços de nomes de rede do Linux isola os recursos de rede, razão pela qual o sucesso do DNS no anfitrião não prova que o contentor cliente partilhe a rede Docker do destino.
Não adicione o IP atual do contentor de destino a /etc/hosts. Os contentores recriados podem receber um endereço diferente, deixando outra dependência obsoleta.
Verifique que rede o proxy inverso utiliza
Inspecione as ligações de rede do proxy e da aplicação, os rótulos do fornecedor e a rede selecionada para o encaminhamento do backend. Teste o alias a partir do contentor do proxy.
O fornecedor Docker do Traefik permite especificar a rede Docker usada para ligações aos backends.
Se o proxy estiver ligado a várias redes, a seleção automática pode ser diferente após a recriação. Defina explicitamente a rede partilhada pretendida e mantenha estável o respetivo nome real.
Remova endpoints obsoletos sem eliminar a rede errada
Liste os contentores ligados às redes antigas e novas. Identifique endpoints órfãos, contentores parados e serviços ativos que ainda dependem da rede antiga do projeto.
O guia de redes de contentores da Red Hat descreve a ligação a redes de contentores definidas pelo utilizador como parte do estado do runtime do contentor, e não do conteúdo dos ficheiros da aplicação.
Remova uma rede antiga apenas depois de confirmar que nenhuma stack ativa a utiliza. Eliminar ambas as redes e recriar tudo de uma só vez destrói as evidências que mostram qual ligação estava incorreta.
Recrie um serviço e verifique o DNS a partir de todos os clientes
Uniformize o nome do projeto ou da rede externa, recrie apenas o serviço afetado e teste o nome do serviço e o alias a partir de cada contentor dependente.
O artigo da ZimaSpace sobre dependências do runtime de contentores apresenta a regra complementar: um teste de conectividade ao nível do anfitrião não valida o espaço de nomes e o percurso de descoberta de serviços de um contentor.
O problema está resolvido quando o alias aponta para o endpoint atual a partir de todos os clientes previstos após a recriação da stack e o reinício, sem endereços IP codificados.
Perguntas frequentes
Os aliases de rede do Docker são globais?
Não. Um alias existe apenas na rede onde está configurado e só é útil para os contentores que partilham essa rede.
Mudar o nome da pasta do Compose pode interromper o DNS?
Sim. A pasta pode afetar o nome predefinido do projeto, que afeta os nomes das redes gerados, a menos que o nome do projeto ou da rede externa seja fixado.
Devo usar container_name para manter o DNS estável?
Normalmente, não. Nomes de serviço estáveis e redes partilhadas explícitas preservam o escalamento do Compose e evitam conflitos com nomes globais.
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...



