Docker Nestjs Dev Environment

NÃO use esta Skill para:

• Configuração de ambientes de produção (use práticas de multi-stage build específicas)
• Deploy em cloud ou orquestradores (Kubernetes, ECS, etc.)
• Otimização de imagens para produção

Entradas esperadas

• tipo_projeto: NestJS (versão, dependências principais)
• servicos_externos: Lista de serviços necessários (PostgreSQL, MySQL, Redis, RabbitMQ, etc.)
• estrutura_atual: Arquivos Docker existentes (se houver) e estrutura do projeto
• problemas_atuais: Descrição de problemas de performance ou configuração (opcional)

Saídas esperadas

• Dockerfile otimizado para desenvolvimento
• docker-compose.yaml configurado para desenvolvimento local
• docker-compose.dev.yaml com overrides para persistência
• Script de inicialização (.docker/start.sh)
• Arquivo .dockerignore completo
• Instruções de uso e comandos úteis
• Explicação das decisões arquiteturais

Passo a passo do fluxo

1. Análise do Projeto

Analise a estrutura do projeto NestJS:

• Leia package.json para identificar dependências
• Verifique estrutura de diretórios (src/, test/, etc.)
• Identifique variáveis de ambiente necessárias
• Liste serviços externos requeridos (databases, message queues, caches)

2. Criação do Dockerfile de Desenvolvimento

Crie um Dockerfile otimizado para desenvolvimento com as seguintes características:

Princípios obrigatórios:

• Use imagem node:20.5.1-slim (ou versão apropriada do projeto)
• Instale @nestjs/cli globalmente para comandos nest
• Defina USER node para segurança
• Use WORKDIR /home/node/app
• Não faça build no Dockerfile de dev (use volume mounts)
• Use CMD que mantém container ativo (tail -f /dev/null ou npm run start:dev)

Template base:

FROM node:20.5.1-slim

# Instalar NestJS CLI globalmente
RUN npm install -g @nestjs/[email protected]

# Segurança: usuário não-root
USER node

# Diretório de trabalho
WORKDIR /home/node/app

# Manter container ativo para desenvolvimento
CMD ["tail", "-f", "/dev/null"]

Explique ao usuário:

• Por quê usar imagem slim (redução de 80% no tamanho)
• Importância de USER node para segurança
• Por quê não instalar dependências no Dockerfile de dev (volume mount faz isso)

3. Criação do docker-compose.yaml Base

Configure docker-compose.yaml com:

Serviço da Aplicação: