O que é Docker Compose e por que usá-lo?

Question

Accepted Answer

**Docker Compose** é uma ferramenta para definir e executar **aplicações multi-container** usando um único arquivo YAML. Em vez de executar muitos comandos `docker run` manualmente, você descreve todos os seus serviços (app, banco de dados, cache) em `docker-compose.yml` e inicia-os juntos com um único comando.

## O problema que o Compose resolve

```text
A real app often has MULTIPLE containers: a web app + a database + a cache + ...
  → manually running each with docker run (ports, networks, volumes, env, dependencies)
    is tedious, error-prone, and hard to reproduce/share
→ Compose defines the WHOLE stack in one file → start it all with one command.
```

## Um docker-compose.yml

```yaml
services:
  web:
    build: .                    # build from the local Dockerfile
    ports:
      - "3000:3000"             # map ports
    environment:
      - DATABASE_URL=postgres://db:5432/myapp
    depends_on:
      - db                       # start db before web
  db:
    image: postgres:16           # use a prebuilt image
    environment:
      - POSTGRES_PASSWORD=secret
    volumes:
      - dbdata:/var/lib/postgresql/data   # persist the database
volumes:
  dbdata:
```

Um único arquivo define todos os serviços, suas imagens/builds, portas, ambiente, volumes e dependências — e eles compartilham uma rede (alcançando-se mutuamente pelo nome do serviço, p.ex. `db`).

## Executando a stack

```bash
docker compose up -d        # build and start ALL services (in the background)
docker compose ps           # list the running services
docker compose logs -f      # view logs from all services
docker compose down         # stop and remove everything
docker compose down -v      # also remove volumes
```

## Por que isso importa

Compreender Docker Compose é valioso porque aplicações reais quase sempre envolvem **múltiplos containers**, e o Compose é a ferramenta padrão para gerenciá-los, portanto é um conhecimento prático importante.

O problema que resolve é real: uma aplicação típica possui vários serviços (um aplicativo web, um banco de dados, um cache, talvez uma fila de mensagens), e executar manualmente cada um com comandos `docker run` separados — configurando portas, redes, volumes, variáveis de ambiente e ordem de inicialização — é tedioso, propenso a erros e difícil de reproduzir ou compartilhar. **O Compose** resolve isso definindo a **stack multi-container inteira em um único arquivo YAML declarativo** e iniciando tudo com um único comando (`docker compose up`), tornando aplicações multi-container fáceis de executar, reproduzir e compartilhar.

Compreender a estrutura do `docker-compose.yml` (definindo serviços com suas imagens/builds, portas, ambiente, volumes e dependências, com serviços automaticamente em rede e acessíveis por nome) e os comandos-chave (`up`, `down`, `ps`, `logs`) é um conhecimento prático e cotidiano para desenvolvimento e execução de aplicações multi-serviço.

O Compose é especialmente valioso para **ambientes de desenvolvimento local** (inicializando uma aplicação com seu banco de dados e dependências em um único comando) e para definir stacks de aplicações de forma reproduzível.

Como aplicações reais são tipicamente multi-container, e como Docker Compose é a ferramenta padrão e amplamente usada para defini-las e executá-las de forma simples (substituindo a orquestração manual tedosa por um único arquivo e comando declarativos), compreender Docker Compose — o que resolve, a estrutura do arquivo compose e os comandos — é um conhecimento valioso, frequentemente aplicado para trabalhar com aplicações multi-container, um companheiro quase essencial do Docker para qualquer aplicação containerizada não trivial e uma ferramenta onipresente em fluxos de trabalho de desenvolvimento.