<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

Como configurar ambiente de desenvolvimento com Docker em 6 dias e acelerar

DA

6 min

Como configurar ambiente de desenvolvimento com Docker em 6 dias e acelerar

Tutorial prático para criar um ambiente de desenvolvimento conteinerizado com Docker Compose, volumes e automação. Do zero ao projeto rodando.

Neste artigo

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.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar

Publicado em

Ver perfil do autor

COMPARTILHAR