É possível alterar a porta publicada de um contentor sem reconstruir a sua base de dados?

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.

Sim, pode alterar a porta publicada de um contentor sem reconstruir a base de dados, desde que a base de dados continue na mesma armazenagem persistente verificada.

Num NAS doméstico ou num anfitrião Docker, a porta visível pertence normalmente ao contentor descartável da aplicação, enquanto os registos, as contas e as definições estão num volume nomeado, numa montagem vinculada ou num serviço de base de dados separado. Por isso, a alteração segura consiste em preservar a definição de implementação e os caminhos persistentes, alterar apenas a regra de publicação do lado do anfitrião, recriar o serviço da aplicação afetado e, em seguida, verificar todos os proxies, marcadores, chamadas de retorno, regras da firewall e verificações de estado que ainda façam referência à porta antiga.

Separe a porta publicada no anfitrião da porta de escuta do contentor

Antes de alterar o mapeamento atual, registe os dois pontos finais separadamente. Em 8080:80, os clientes ligam-se à porta 8080 do anfitrião Docker, enquanto a aplicação continua à escuta na porta 80 dentro do contentor. Alterar o lado esquerdo não altera automaticamente o processo da aplicação nem a ligação à respetiva base de dados.

Um caso de resolução de problemas da comunidade Docker salienta que o mapeamento no anfitrião e o serviço de escuta interno são distintos, e que uma nova porta publicada não pode funcionar se não houver nada à escuta internamente na porta de destino.

Inspecione as portas publicadas e os sockets de escuta do contentor em execução e, em seguida, teste o ponto final interno a partir do contentor ou da respetiva rede. Mantenha a porta interna inalterada, a menos que a própria aplicação tenha de mudar. Este primeiro teste evita que uma simples alteração da porta no anfitrião se transforme numa reconfiguração desnecessária da aplicação.

Proteja o caminho atual da base de dados antes de recriar o serviço

Registe o ficheiro Compose, a etiqueta ou o resumo da imagem, os ficheiros de ambiente, os volumes nomeados, as montagens vinculadas, os nomes das redes, os segredos e o nome do anfitrião da base de dados. O objetivo é determinar que objeto contém os dados persistentes antes de o Docker substituir o contentor da aplicação.

Alterar a publicação de portas exige uma nova configuração do contentor, mas não exige criar uma nova imagem nem uma nova base de dados. Uma resposta prática sobre Docker distingue a recriação do contentor da reconstrução da imagem da aplicação quando as definições das portas são alteradas.

Se o serviço for importante, faça uma cópia de segurança ou um instantâneo atual da base de dados, consistente com a aplicação, e confirme que o caminho da base de dados não está na camada de escrita do contentor. Pare se a lista de pontos de montagem for ambígua, se o nome do volume tiver mudado ou se a aplicação atual parecer estar a utilizar uma base de dados vazia inesperada.

Altere apenas o mapeamento do lado do anfitrião e recrie o serviço da aplicação

Edite o serviço da aplicação, alterando um mapeamento como 8080:80 para 8081:80. Mantenha a imagem, a porta interna, os volumes, o URL da base de dados, o nome do serviço, as redes e o mapeamento do utilizador inalterados, salvo se existir outro requisito comprovado.

A sintaxe de portas do Compose é interpretada do anfitrião para o contentor, pelo que alterar o lado do anfitrião deixa o processo a escutar na porta interna que já utilizava. Um exemplo num fórum sobre Docker explica por que razão o lado esquerdo é a porta do anfitrião e o lado direito tem de continuar a corresponder à porta de escuta da aplicação.

Recrie apenas o serviço da aplicação com a definição atualizada. Não use um comando da stack que remova volumes, não inicialize novamente a base de dados e não acrescente --build, a menos que a própria imagem tenha sido alterada. Após a recriação, inspecione os pontos de montagem efetivos e o mapeamento de portas antes de permitir que as migrações ou as tarefas em segundo plano sejam executadas.

Atualize todos os caminhos dos clientes que dependem da porta antiga

Um marcador do browser é apenas um dos elementos que usam a porta publicada. Os proxies inversos, os reencaminhamentos do router, as firewalls locais, as sondas de monitorização, as aplicações móveis, os destinos de webhooks, os callbacks OAuth, as listas de permissões CORS e os URLs públicos gerados podem continuar a apontar para o endpoint anterior.

Algumas aplicações autoalojadas fazem pedidos pelo endereço de loopback ou constroem URLs de callback a partir do endereço público configurado. Uma discussão sobre um contentor WordPress mostra como uma alteração no mapeamento externo pode revelar um comportamento de loopback sensível à porta, mesmo quando a base de dados continua saudável.

Procure a porta antiga no projeto Compose, na configuração do proxy, nos ficheiros de ambiente e nas definições da aplicação. Atualize apenas as camadas que utilizam efetivamente o endpoint do anfitrião. Normalmente, os contentores internos devem continuar a utilizar o nome do serviço e a porta interna, em vez da nova porta publicada no anfitrião.

Mantenha a Base de Dados no Seu Percurso Privado de Contentor

Não altere nem publique a porta da base de dados apenas porque a porta da aplicação Web no anfitrião mudou. Uma base de dados utilizada apenas por contentores da mesma stack pode continuar acessível pelo nome do serviço e pela porta interna, sem qualquer publicação no anfitrião.

Confundir o endpoint público da aplicação com a ligação à base de dados pode causar uma segunda interrupção: a aplicação pode ser configurada com o endereço do NAS e uma porta do anfitrião, mesmo que a base de dados deva continuar numa rede Docker privada. Essa alteração acrescenta variáveis de firewall, NAT e autenticação, sem ajudar o browser a aceder ao serviço Web.

A partir do contentor recriado da aplicação, resolva o nome do serviço da base de dados, estabeleça ligação à respetiva porta TCP interna, autentique-se e execute uma leitura inofensiva. Se esse percurso não tiver mudado, não o altere. Se o teste à base de dados falhar, restaure a definição original da aplicação antes de resolver o problema de rede ou de credenciais em separado.

Verificar a Nova Porta sem Tocar nos Dados Persistentes

Teste diretamente a nova porta no anfitrião e, em seguida, teste o nome de anfitrião habitual ou o percurso através do proxy inverso. Confirme o início de sessão, a leitura de registos, uma escrita reversível, os carregamentos, as tarefas agendadas, as integrações e o reinício controlado de um contentor.

O guia da ZimaSpace sobre como fazer corresponder as verificações de estado aos caminhos reais da aplicação é o passo seguinte quando o novo endpoint no browser funciona, mas o Docker continua a indicar que o serviço não está saudável.

A alteração só fica concluída quando a nova porta publicada se mantém após a recriação e o reinício, o proxy e os clientes deixam de usar o endpoint antigo, a aplicação volta a ligar-se à mesma base de dados persistente e a cópia de segurança da base de dados continua disponível. Reverta o mapeamento da porta se a aplicação arrancar com um novo estado vazio ou tentar uma migração inesperada.

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.