docker compose port

O comando docker compose port é utilizado para exibir as portas mapeadas de um serviço em execução em um container gerenciado pelo Docker Compose. Ele mostra qual porta de um serviço específico está sendo mapeada para a máquina host, facilitando a identificação de como acessar serviços externos, como aplicações web ou bancos de dados, a partir do host ou de outras máquinas.

Uso Básico

docker compose port SERVICE PRIVATE_PORT

• SERVICE: O nome do serviço definido no arquivo docker-compose.yml para o qual você deseja consultar o mapeamento de portas.

• PRIVATE_PORT: A porta interna do container (ou seja, a porta exposta dentro do container) que você deseja consultar para ver como está mapeada para a máquina host.

Principais Opções

• --index index: Quando o serviço possui várias réplicas, essa opção permite especificar qual instância (replica) você deseja consultar, usando um índice numérico.

Exemplos de Uso

1. Obter o mapeamento de porta de um serviço específico:

   docker compose port web 80

   Neste exemplo, o comando mostra qual porta da máquina host está mapeada para a porta 80 do serviço web. A saída pode ser algo como 0.0.0.0:49153, indicando que a porta 49153 do host está direcionada para a porta 80 do container.

2. Consultar o mapeamento de porta em uma instância específica de um serviço:

   docker compose port --index 2 web 80

   Se o serviço web tiver várias réplicas, este comando exibirá a porta mapeada para a porta 80 da segunda instância.

3. Usar com serviços sem portas expostas: Se o serviço não tiver portas publicadas, o comando não retornará nenhuma saída ou indicará que não há portas mapeadas.

Casos de Uso Comuns

• Identificação de Portas Mapeadas: Útil para identificar rapidamente como acessar um serviço em execução dentro de um container a partir do host ou de outras máquinas, especialmente em ambientes onde as portas são atribuídas dinamicamente.

• Depuração e Testes: Durante o desenvolvimento, você pode precisar saber para qual porta externa um serviço interno foi mapeado, para testar ou depurar aplicações.

• Gerenciamento de Serviços em Produção: Em ambientes de produção, o comando port ajuda na verificação e documentação das configurações de rede dos serviços, garantindo que o acesso externo esteja configurado corretamente.

Considerações Finais

O comando docker compose port é uma ferramenta prática para descobrir rapidamente o mapeamento de portas entre containers e o host. Ele é especialmente útil quando você trabalha com múltiplos serviços e precisa entender como as portas internas dos containers são expostas para o mundo externo. Esse comando facilita o acesso e a integração dos serviços rodando em containers com outros sistemas e ferramentas.