Como funcionam as redes Docker e o mapeamento de portas?

Question

Accepted Answer

Docker fornece **redes** para que contêineres possam se comunicar entre si e com o mundo externo. **Mapeamento de portas** expõe as portas de um contêiner ao host, e **redes** permitem que contêineres se comuniquem entre si por nome. Entender o básico é essencial para executar aplicações conectadas.

## Mapeamento de portas — expor contêineres ao host

```bash
# -p HOST_PORT:CONTAINER_PORT maps a host port to a container port
docker run -p 8080:80 nginx
# → nginx listens on port 80 INSIDE the container;
#   accessing localhost:8080 on the HOST reaches it
# → without -p, the container's ports aren't accessible from outside
```

**Mapeamento de portas** (`-p host:container`) torna a porta interna de um contêiner acessível a partir do host — necessário para acessar uma aplicação web containerizada, API, etc. de fora do contêiner.

## Comunicação entre contêineres (redes definidas pelo usuário)

```bash
# create a network; containers on it can reach each other BY NAME
docker network create mynet
docker run -d --name db --network mynet postgres
docker run -d --name api --network mynet myapi
# → the "api" container can connect to the database at hostname "db" (Docker DNS)
#   e.g. DATABASE_URL=postgres://db:5432/...
```

Em uma **rede definida pelo usuário**, contêineres podem acessar um ao outro pelo **nome do contêiner** (Docker fornece resolução DNS) — então um contêiner de aplicação se conecta a um contêiner de banco de dados usando seu nome como hostname, sem necessidade de endereços IP.

## Tipos de rede

```text
bridge   → the default; containers on a bridge network communicate; isolated from host
           (user-defined bridge networks add name-based DNS — preferred)
host     → the container shares the host's network directly (no isolation, no mapping)
none     → no networking
overlay  → spans multiple hosts (for Docker Swarm / multi-host clusters)
```

## Por que isso importa

Entender redes Docker e mapeamento de portas é essencial para executar aplicações reais e conectadas no Docker, portanto é conhecimento prático importante. **Mapeamento de portas** (`-p host:container`) é fundamental e usado constantemente — sem ele, uma aplicação web ou API containerizada não é acessível de fora do contêiner, então entender como expor portas de contêiner ao host é necessário para realmente usar serviços containerizados.

Igualmente importante é a **comunicação entre contêineres**: entender que em uma **rede definida pelo usuário**, contêineres podem acessar um ao outro **por nome** (via DNS integrado do Docker) é essencial para aplicações multi-contêiner — um contêiner de aplicação se conectando a seu contêiner de banco de dados usando o nome do contêiner como hostname (ex: `postgres://db:5432`) é um padrão quase universal, e entendê-lo é necessário para construir aplicações compostas por múltiplos contêineres (app + banco de dados + cache, etc.).

Conhecer os **tipos de rede** (bridge como padrão com bridges definidas pelo usuário adicionando DNS baseado em nomes, host para compartilhar a rede do host, overlay para clusters multi-host) fornece o contexto para configurar redes apropriadamente.

Como aplicações reais envolvem serviços se comunicando (uma aplicação web acessando um banco de dados, serviços chamando um ao outro) e sendo acessados de fora (portas expostas), e como as redes Docker (mapeamento de portas para acesso externo, comunicação entre contêineres nomeados em redes) é como essa conectividade funciona, entender o básico de redes Docker é conhecimento essencial e frequentemente aplicado para executar aplicações containerizadas conectadas — necessário para qualquer coisa além de um contêiner isolado único, e uma habilidade fundamental para as aplicações multi-contêiner que são a norma no uso real do Docker.