Docker na Prática: Guia Completo Para Desenvolvedores

Docker transformou a forma como desenvolvemos, testamos e entregamos software. Se você ainda não usa containers no seu workflow, está perdendo produtividade. Neste guia, vou mostrar como usar Docker na prática, desde o básico até configurações de produção.

Por Que Docker?

O problema clássico: "funciona na minha máquina". Docker resolve isso empacotando sua aplicação com todas as dependências em um container isolado que roda identicamente em qualquer ambiente.

Benefícios concretos: - Ambiente consistente — desenvolvimento, staging e produção idênticos - Onboarding rápido — novo dev roda o projeto com um único comando - Isolamento — cada projeto com suas versões de Node, PHP, MySQL sem conflitos - CI/CD simplificado — build uma vez, deploy em qualquer lugar

Conceitos Fundamentais

Imagem — blueprint do seu container. Pense como uma "foto" do ambiente configurado. Criada a partir de um Dockerfile.

Container — instância em execução de uma imagem. É o ambiente rodando de fato. Você pode ter múltiplos containers da mesma imagem.

Dockerfile — arquivo de instruções para construir uma imagem. Cada instrução cria uma camada.

Docker Compose — ferramenta para definir e executar múltiplos containers. Ideal para ambientes com app + banco de dados + cache.

Dockerfile Para uma API Node.js

Um Dockerfile produção-ready para uma API Node.js com multi-stage build:

A primeira stage (builder) instala dependências e compila. A segunda stage (runner) copia apenas o necessário, resultando em uma imagem muito menor.

Boas práticas aplicadas: - Multi-stage build reduz o tamanho final da imagem - Usuário não-root para segurança - .dockerignore para excluir node_modules, .git, etc. - Camadas otimizadas — package.json copiado antes do código para cache de dependências

Docker Compose Para Desenvolvimento

Um docker-compose.yml típico para uma API com PostgreSQL e Redis inclui três serviços: o app rodando na porta 3000 com hot-reload via volume mount, o PostgreSQL na porta 5432 com volume persistente para dados, e o Redis na porta 6379 para cache e filas.

Comandos essenciais: - Subir tudo: docker compose up -d - Ver logs: docker compose logs -f app - Rebuild após mudar Dockerfile: docker compose up --build - Parar e limpar: docker compose down -v

Dicas de Performance

• Use imagens Alpine — node:20-alpine é 5x menor que node:20
• Otimize camadas — agrupe RUN commands com && para reduzir camadas
• Use .dockerignore — exclua node_modules, .git, testes e docs
• Cache de dependências — copie package.json antes do código fonte

Docker em Produção

Para produção, considere: - Docker Swarm ou Kubernetes para orquestração de múltiplos containers - Health checks no Dockerfile para monitoramento automático - Logs centralizados com fluentd ou CloudWatch - Secrets management — nunca hardcode senhas no Dockerfile

Conclusão

Docker é uma ferramenta essencial para qualquer desenvolvedor moderno. Comece com docker-compose para desenvolvimento local e evolua para deploy containerizado em produção.

Se precisar de ajuda para containerizar seu projeto ou estruturar seu pipeline de CI/CD, entre em contato.