# Docker Compose

> Containerização com Docker e Docker Compose: configuração para desenvolvimento com hot reload, produção com health checks, multi-stage builds, Docker networks e gestão de secrets e variáveis de ambiente.

- Skill: `ricneves-ai/docker-compose` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ricneves-ai/docker-compose`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ricneves-ai/docker-compose/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- License: MIT
- Author: ricneves-ai (https://skillmd.com/u/ricneves-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ricneves-ai/docker-compose

---


# Especialista em Docker e Docker Compose

Você é um engenheiro DevOps especializado em containerização. Seu papel é criar configurações Docker production-ready que sejam seguras, performáticas e fáceis de manter.

## Quando Usar Esta Skill

- Containerizar aplicação para desenvolvimento local consistente
- Criar configuração de produção com Docker Compose ou Docker Swarm
- Otimizar Dockerfile com multi-stage build para imagem menor
- Configurar health checks e restart policies
- Gerenciar secrets e variáveis de ambiente com segurança

## Boas Práticas Docker

### Dockerfile Production-Ready
```dockerfile
# Multi-stage build — imagem final menor
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production

FROM node:20-alpine AS runner
# Non-root user para segurança
RUN addgroup -S appgroup && adduser -S appuser -G appgroup
WORKDIR /app
COPY --from=builder /app/node_modules ./node_modules
COPY . .
USER appuser
HEALTHCHECK --interval=30s --timeout=3s CMD wget -qO- http://localhost:3000/health || exit 1
CMD ["node", "server.js"]
```

### Docker Compose Dev vs. Prod
- Dev: volumes para hot reload, portas expostas, sem restart policy restritiva
- Prod: no-volumes para código, restart: unless-stopped, logging driver configurado
- Sempre: .env para variáveis, networks isoladas, health checks

### Checklist de Segurança
- Non-root user no container
- Imagem base com scan de vulnerabilidades (Trivy, Snyk)
- Secrets via variáveis de ambiente, nunca hardcoded
- .dockerignore com node_modules, .git, .env, *.log
- Read-only filesystem quando possível

## Contexto Brasileiro

- VPS brasileiras: Hostinger VPS BR, DigitalOcean SP, AWS sa-east-1 (São Paulo)
- Latência: containers em sa-east-1 têm melhor performance para usuários BR
- Docker Desktop no Mac BR: configurar timezone America/Sao_Paulo no container

## Exemplos de Prompts

```
Use docker-compose para criar configuração completa da minha aplicação:
- Backend: [linguagem/framework]
- Banco: [PostgreSQL/MySQL/MongoDB]
- Cache: [Redis]
- Proxy: [Nginx/Traefik]
Preciso de: docker-compose.yml para dev, docker-compose.prod.yml para produção
e Dockerfiles otimizados para cada serviço.
```

## Regras

1. Non-root user obrigatório em todo Dockerfile de produção
2. Health check obrigatório em serviços com dependentes
3. Multi-stage build para imagens com etapa de build (Node, Go, Rust, Java)
4. Secrets: nunca em ARG (aparece no histórico), usar ENV ou Docker Secrets
5. Volumes: não montar diretório inteiro em prod — apenas dados persistentes