Neste artigo
- O que é configurar ambiente de desenvolvimento com Docker e por que fazer isso?
- O que você precisa antes de começar?
- Como instalar e configurar Docker e Docker Compose?
- Como subir um projeto real com Docker Compose, volumes e portas?
- Como automatizar o fluxo com Makefile e evitar erros comuns?
- Boas práticas, FAQ e próximos passos
- Como usar docker-compose.yml para definir serviços de backend e frontend no desenvolvimento?
- Quais comandos Docker são essenciais para reiniciar e remover containers após o uso diário?
- Como mapear portas host-container ao configurar ambiente de desenvolvimento com Docker?
- Como persistir dados de banco de dados em containers Docker usando volumes nomeados?
- Como evitar conflitos de porta ao rodar múltiplos projetos Docker na mesma máquina?
- Qual a melhor prática para compartilhar código-fonte entre host e container usando bind mounts?
O que é configurar ambiente de desenvolvimento com Docker e por que fazer isso?
Configurar ambiente de desenvolvimento com Docker significa empacotar todas as dependências (runtime, bibliotecas, banco de dados, ferramentas) em containers isolados, garantindo que o mesmo setup funcione em qualquer máquina. Você elimina o clássico "na minha máquina funciona" e ganha reprodutibilidade. Neste tutorial, vamos construir um ambiente com backend, frontend e banco PostgreSQL usando Docker Compose, volumes para persistência e um Makefile para automatizar tarefas.
Para quem está começando, vale entender o básico de gerenciamento de containers Docker: imagens, containers, redes e volumes. Se você já usa Docker no dia a dia, pode pular direto para a configuração prática.
O que você precisa antes de começar?
Antes de tudo, você precisa ter o Docker Engine e o Docker Compose instalados. Também é importante conhecer comandos básicos de terminal e ter portas livres (vamos usar 3000, 8000 e 5432). Um editor como VS Code ajuda, mas não é obrigatório.
Resposta rápida: Docker Engine 20.10+, Docker Compose v2 (já vem com o Docker Desktop), 4 GB de RAM livre e portas 3000, 8000 e 5432 disponíveis.
Cursos Google Ciee gratuitos certificado
Como instalar e configurar Docker e Docker Compose?
No Linux, use o script oficial de instalação. No macOS e Windows, baixe o Docker Desktop, que já inclui o Compose. Após instalar, verifique as versões com docker --version e docker compose version. Se ambos retornarem número de versão, está pronto.
# Linux (Ubuntu/Debian)
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker
# Verificar
docker --version
docker compose version
No Windows, o Docker Desktop requer WSL2 habilitado. No macOS, o instalador padrão já configura tudo. Se o comando docker compose não for encontrado, instale o plugin separadamente (em sistemas Linux mais antigos, use docker-compose com hífen).
Como subir um projeto real com Docker Compose, volumes e portas?
Vamos criar um docker-compose.yml que define três serviços: backend (Node.js), frontend (React) e banco (PostgreSQL). O compose orquestra tudo, mapeia portas e configura volumes para persistir dados e compartilhar código.
Databricks cursos gratuitos português
version: '3.8'
services:
backend:
build: ./backend
ports:
- "8000:8000"
volumes:
- ./backend:/app
- /app/node_modules
depends_on:
- db
environment:
- DATABASE_URL=postgres://user:pass@db:5432/mydb
frontend:
build: ./frontend
ports:
- "3000:3000"
volumes:
- ./frontend:/app
- /app/node_modules
depends_on:
- backend
db:
image: postgres:15
ports:
- "5432:5432"
environment:
POSTGRES_USER: user
POSTGRES_PASSWORD: pass
POSTGRES_DB: mydb
volumes:
- postgres_data:/var/lib/postgresql/data
volumes:
postgres_data:
Explicação rápida: o serviço backend usa bind mount (./backend:/app) para refletir alterações do host no container. O volume anônimo /app/node_modules evita que o node_modules do host sobrescreva o do container. O serviço db usa volume nomeado postgres_data para persistir os dados mesmo após remover o container. As portas são mapeadas host:container, então acesse localhost:3000 para o frontend.
Para subir tudo, execute docker compose up -d. O -d roda em background. Acompanhe logs com docker compose logs -f.
Dica:Use docker compose up --build na primeira vez para construir as imagens. Depois, se alterar dependências, rode novamente com --build.
Curso gratuito analise de dados dashboards google Looker Studio Senai
Como automatizar o fluxo com Makefile e evitar erros comuns?
Criar um Makefile simples economiza digitação e padroniza comandos para todo o time. Coloque na raiz do projeto:
.PHONY: up down logs build restart
up:
docker compose up -d
down:
docker compose down
logs:
docker compose logs -f
build:
docker compose up -d --build
restart:
docker compose restart
Agora, em vez de lembrar dos comandos, basta rodar make up ou make down. Isso reduz erros e ajuda novos membros do time.
Erros comuns: conflito de portas (algo já está rodando na 3000 ou 8000), permissões negadas em volumes (principalmente no Linux, onde o container cria arquivos com dono root), e esquecer de remover volumes antigos com docker compose down -v quando muda a estrutura do banco. Para conflito de portas, altere o mapeamento para 3001:3000, por exemplo. Ou use um arquivo .env para definir portas dinamicamente.
Curso gratuito Microsoft analise de dados power bi certificado
Boas práticas, FAQ e próximos passos
Mantenha as imagens enxutas usando multi-stage builds no Dockerfile, evite instalar dependências desnecessárias e sempre use versões fixas nas imagens (ex: node:18-alpine em vez de node:latest). Para dados persistentes, prefira volumes nomeados a bind mounts. E lembre-se: containers são efêmeros, então nunca armazene dados importantes fora de volumes.
Se você quer se aprofundar em carreira e DevOps, confira nosso plano de carreira para analista de dados com Microsoft Power BI e o curso de analista de cibersegurança júnior da Cisco. Ambos abordam fundamentos de infraestrutura que se conectam com Docker.
Próximos passos: adicione um serviço de cache (Redis), configure um proxy reverso (Nginx) ou explore orquestração com Kubernetes. O importante é dominar o básico de gerenciamento de containers Docker antes de partir para ferramentas mais complexas.
Curso gratuito power bi analise de dados Bradesco
Perguntas frequentes
Como usar docker-compose.yml para definir serviços de backend e frontend no desenvolvimento?
Você define cada serviço em uma seção separada dentro de services:, especificando imagem ou build, portas, volumes e variáveis de ambiente. O Compose cria uma rede interna para que os serviços se comuniquem pelo nome do serviço (ex: db).
Quais comandos Docker são essenciais para reiniciar e remover containers após o uso diário?
Use docker compose down para parar e remover containers, redes e volumes anônimos. Para reiniciar, docker compose restart. Para remover tudo, incluindo volumes nomeados, docker compose down -v.
Como mapear portas host-container ao configurar ambiente de desenvolvimento com Docker?
No Compose, use ports: - "host:container". Exemplo: 3000:3000 mapeia a porta 3000 do host para a 3000 do container. Para evitar conflitos, mude a porta do host para 3001, por exemplo.
Como persistir dados de banco de dados em containers Docker usando volumes nomeados?
Declare um volume nomeado na seção volumes: do Compose e monte-o no diretório de dados do banco. Exemplo: postgres_data:/var/lib/postgresql/data. Assim, os dados sobrevivem a reinicializações e remoções do container.
Como evitar conflitos de porta ao rodar múltiplos projetos Docker na mesma máquina?
Use portas diferentes para cada projeto no mapeamento host:container. Ou utilize um arquivo .env para definir a porta do host dinamicamente, como PORT=3000 e no compose ${PORT}:3000.
Qual a melhor prática para compartilhar código-fonte entre host e container usando bind mounts?
Monte o diretório do projeto como bind mount (ex: ./app:/app) e use um volume anônimo para diretórios que não devem ser sobrescritos (ex: /app/node_modules). Isso mantém a performance e evita conflitos de dependências.