TECNOLANDIA TECH
Publicidade

Conecte-se com o Tecnolândia Tech

BLOG + INSTAGRAM + FACEBOOK

Tecnologia na prática, em todos os formatos.

Aqui no Tecnolândia Tech, você encontra artigos e guias completos. No Instagram @djwinformatica e no Facebook TecnoInfo, acompanhe vídeos, dicas e novidades de IA, automação e tecnologia. São nossos canais oficiais.

Docker Compose: Suba Qualquer Stack com um Comando

Docker Compose: Suba Qualquer Stack com um Comando

Imagem: Pexels

Subir banco + cache + aplicação na mão é o ritual que consome o primeiro dia de qualquer projeto novo: três terminais, portas anotadas, container esquecido rodando. O Docker Compose resolve isso com um único arquivo declarando a stack inteira e um comando que sobe tudo na ordem certa, na mesma rede, com volumes persistentes. Este guia monta uma stack real de aplicação Python com PostgreSQL e Redis, explica cada bloco do YAML e os comandos do dia a dia.

1. O arquivo que define a stack inteira

O Compose vive no docker-compose.yml (ou compose.yaml) na raiz do projeto. Estrutura de uma stack com app, banco e cache:

services:
  app:
    build: .
    ports:
      - "8000:8000"
    environment:
      DATABASE_URL: postgresql://app:senha@db:5432/app
      REDIS_URL: redis://cache:6379/0
    depends_on:
      db:
        condition: service_healthy
    volumes:
      - .:/code

  db:
    image: postgres:16
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: senha
      POSTGRES_DB: app
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U app"]
      interval: 5s
      timeout: 3s
      retries: 10

  cache:
    image: redis:7-alpine

volumes:
  pgdata:

Três conceitos sustentam tudo. build: . manda o Compose construir a imagem da aplicação a partir do Dockerfile do diretório — as outras usam imagens prontas. O hostname interno é o nome do serviço: a app acessa o banco como db, nunca localhost, porque cada serviço é um container. E o volume nomeado pgdata garante que os dados sobrevivam quando você derrubar a stack.

2. Ordem de subida: depends_on não basta sozinho

depends_on apenas garante que o container do banco esteja rodando antes da app — não que esteja pronto para aceitar conexão. Por isso o healthcheck com pg_isready e o condition: service_healthy: sem isso, o clássico erro "connection refused" na primeira subida é garantido. Em aplicação, reforce ainda com retry de conexão no boot — defesa em profundidade barata.

3. Comandos do dia a dia

docker compose up -d          # sobe tudo em segundo plano
docker compose ps             # o que está rodando
docker compose logs -f app    # logs da aplicação em tempo real
docker compose exec db psql -U app -d app  # shell no banco
docker compose down            # para e remove os containers
docker compose down -v         # para e apaga os volumes (cuidado!)

Note a diferença entre down e down -v: o primeiro mantém os dados no volume; o segundo apaga — útil em teste, perigoso em produção. Para reconstruir a app depois de mudar código ou dependências, docker compose up -d --build.

4. Arquivos por ambiente: dev e produção separados

O Compose aceita camadas: o arquivo base e um override. Padrão comum é docker-compose.yml (produção enxuta) e docker-compose.override.yml (dev: código montado em volume, porta exposta, modo debug). Na subida, os dois carregam juntos automaticamente; para subir só a base, use docker compose -f docker-compose.yml up -d. Senhas não ficam no YAML: use .env no mesmo diretório (o Compose lê variáveis automaticamente) e versione o .env.example, não o .env.

5. Rede, portas e o que fica exposto

Serviços falam entre si pela rede padrão do Compose sem configuração; ports só é para o que precisa ser alcançado de fora (a app). Expor o Postgres na porta 5432 do host em desenvolvimento é comum para usar o DataGrip; em produção, remova a linha de ports e deixe o banco alcançável apenas pela rede interna. Se quiser uma rede nomeada própria (por exemplo, para isolar uma stack de teste), declare networks: no topo e aponte cada serviço.

6. Erros que todo mundo comete na primeira stack

  • Volume em banco sem declaration: sem a chave volumes: no rodapé do arquivo, o Compose não salva os dados.
  • Build esquecido no CI: up -d sem --build roda imagem velha após mudança de código.
  • Secrets em imagem: o que entra no Dockerfile vai para a imagem; segredos entram por variáveis de ambiente em tempo de execução.
  • Restart infinito: app que morre no boot com restart: unless-stopped esconde o erro real — veja os logs antes de reativar.

Comece com o compose.yaml deste guia em qualquer projeto que hoje você roda com três terminais abertos. Depois que a stack subir com um comando, adicione o serviço que faltava — worker, Nginx, MailHog para testar e-mail — e perceba o efeito: o projeto inteiro deixa de depender do estado da sua máquina e passa a ser reproduzível em qualquer notebook com Docker instalado.

Publicidade