Nestjs Deployment

• Rule: Explicitly set Max Old Space.
• Command: node --max-old-space-size=XXX dist/main
• Calculation: Set to ~75-80% of Kubernetes Limit. (Limit: 1GB -> OldSpace: 800MB).

Init Patterns

• Database Migrations:
  • Anti-Pattern: Running migration in main.ts on startup.
  • Pro Pattern: Use an Init Container in Kubernetes that runs npm run typeorm:migration:run before the app container starts.

Environment Variables & CI/CD

• CI/CD Pipelines (GitHub, GitLab, Azure, etc.):
  • If you modify src/config/env.validation.ts to add a new environment variable, you MUST map it explicitly in your deployment pipeline/infrastructure-as-code.
  • Platform Context:
    • Cloud Run/ECS: Variables must be explicitly passed in the service definition.
    • Kubernetes: New variables must be added to the Deployment manifest or ConfigMap/Secret.
    • Lambda/Serverless: Must be added to serverless.yml or provider console.
  • Fundamental Rule: Application code configuration changes are "breaking changes" for the infrastructure layer. Never assume environment inheritance.

Anti-Patterns

• No migrations in main.ts: Use K8s Init Containers or pre-deploy CI steps for migration runs.
• No root user in Docker: Always add USER node to Dockerfile; running as root is a security risk.
• No unbounded Node heap: Set --max-old-space-size to ~75% of container memory limit.