docker-compose

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

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