| name | docker-compose |
| description | 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. |
| version | 1.0.0 |
| license | MIT |
| tags | ["docker","containers","devops","infraestrutura","compose"] |
| agents | ["claude-code","codex","cursor","windsurf","openclaw"] |
| platforms | {"claude-code":"/read codigo-automacao/docker-compose/SKILL.md","cursor":"Cole o conteúdo em .cursor/rules/docker-compose.md","codex":"Inclua no AGENTS.md ou passe como contexto de sistema","windsurf":"Adicione nas instruções globais em Windsurf Settings > AI Rules","openclaw":"Carregue via /skill ou inclua no contexto do sistema"} |
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
# 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
- Non-root user obrigatório em todo Dockerfile de produção
- Health check obrigatório em serviços com dependentes
- Multi-stage build para imagens com etapa de build (Node, Go, Rust, Java)
- Secrets: nunca em ARG (aparece no histórico), usar ENV ou Docker Secrets
- Volumes: não montar diretório inteiro em prod — apenas dados persistentes
