배포 — PM2, Docker, 환경 변수 관리

              ┌── Worker 1 (CPU 코어 1)
              │
PM2 Master ──├── Worker 2 (CPU 코어 2)
              │
              ├── Worker 3 (CPU 코어 3)
              │
              └── Worker 4 (CPU 코어 4)

# 클러스터 모드로 시작 (CPU 코어 수만큼 프로세스)
pm2 start server.js -i max

# 상태 확인
pm2 status

# 무중단 재시작
pm2 reload server.js

// ecosystem.config.js
module.exports = {
  apps: [{
    name: 'express-api',
    script: './server.js',
    instances: 'max',         // CPU 코어 수만큼
    exec_mode: 'cluster',     // 클러스터 모드
    env: {
      NODE_ENV: 'production',
      PORT: 3000,
    },
    max_memory_restart: '500M', // 메모리 500MB 초과 시 재시작
    log_date_format: 'YYYY-MM-DD HH:mm:ss',
  }],
};

pm2 start ecosystem.config.js

# Stage 1: 빌드
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci                    # ← devDependencies 포함 설치
COPY . .
RUN npm run build             # TypeScript 컴파일 등

# Stage 2: 런타임
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev         # ← devDependencies 제외
COPY --from=builder /app/dist ./dist
EXPOSE 3000
USER node                     # ← root가 아닌 node 유저로 실행
CMD ["node", "dist/server.js"]

node_modules
.git
.env
npm-debug.log
dist

코드에 하드코딩     ❌  보안 취약, 환경별 분기 불가능
설정 파일(.env)    △  gitignore 필수, 로컬 개발용
환경 변수          ✅  환경별로 다른 값, 코드 변경 불필요

# .env (gitignore에 추가 필수!)
DATABASE_URL=postgresql://localhost:5432/mydb
JWT_SECRET=dev-secret-key
PORT=3000

// 앱 시작 시점에 한 번만 로드
require('dotenv').config();

const port = process.env.PORT || 3000;
const dbUrl = process.env.DATABASE_URL;

const required = ['DATABASE_URL', 'JWT_SECRET'];
for (const key of required) {
  if (!process.env[key]) {
    console.error(`Missing env: ${key}`);
    process.exit(1); // ← 환경 변수 없으면 시작하지 않음
  }
}

FROM node:20-alpine
RUN npm install -g pm2
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
EXPOSE 3000
USER node
CMD ["pm2-runtime", "ecosystem.config.js"]

# .gitignore에 반드시 추가
.env
.env.local
.env.production

// 잘못된 패턴 — 워커 간 공유 안 됨
const sessions = new Map();

// 올바른 패턴 — Redis로 외부 저장소 사용
const session = require('express-session');
const RedisStore = require('connect-redis').default;