deploying-nestjs-production

name	deploying-nestjs-production
description	Prepares a NestJS service for production: graceful shutdown, health/readiness, structured logs, config, Dockerfile, CI gates, and rollout safety. Use when promoting a service to staging/production or auditing readiness.

Deploying NestJS Production

When to use

• Promoting a service to staging/production
• Auditing production readiness
• Adding graceful shutdown, health checks, Dockerfile

Core rules

1. Graceful shutdown on SIGTERM/SIGINT
2. Health (/health) and readiness (/ready) endpoints
3. Structured JSON logs via global interceptor
4. Config validated at boot (Zod), secrets not logged
5. Dockerfile: multi-stage build, non-root user
6. CI gates: tsc --noEmit, ESLint, tests, npm audit

Reference shape (TypeScript)

Graceful Shutdown

// main.ts
const app = await NestFactory.create(AppModule);
app.enableShutdownHooks();
await app.listen(3000);

Health Controller

@Controller('health')
export class HealthController {
  @Get() health() { return { status: 'ok' }; }
  @Get('ready') ready() { return { status: 'ready' }; }
}

Dockerfile

FROM node:18 AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build

FROM node:18-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
USER node
CMD ["node", "dist/main.js"]

Examples — Do

// Graceful shutdown with connection cleanup
app.enableShutdownHooks();
// Health endpoint returns DB/Redis status

Examples — Don't

// ❌ No shutdown hooks
const app = await NestFactory.create(AppModule);
await app.listen(3000);

Checklist

• Graceful shutdown enabled
• Health and readiness endpoints
• Structured JSON logs
• Config validated at boot
• Dockerfile multi-stage build
• CI gates pass

See reference/deployment-patterns.md for full patterns.