PM2 완전 정복 4편 — God Daemon과 클러스터 모드, 그리고 진짜 무중단 재시작

  ┌─────────────┐    RPC (Unix socket)   ┌──────────────────────────┐
  │  pm2 CLI    │ ─────────────────────▶ │   PM2 God Daemon         │
  │ (단명 프로세스)│ ◀───────────────────── │   (상주 프로세스)          │
  └─────────────┘                        │                          │
                                         │  ┌──────┐ ┌──────┐       │
                                         │  │ api  │ │ api  │  ...  │
                                         │  │ #0   │ │ #1   │       │
                                         │  └──────┘ └──────┘       │
                                         └──────────────────────────┘

~/.pm2/
├── dump.pm2          # pm2 save 결과
├── pm2.log           # 데몬 자체 로그 (문제 추적 시 중요!)
├── pm2.pid           # 데몬 PID
├── rpc.sock          # CLI ↔ 데몬 명령 채널
├── pub.sock          # 이벤트 발행 채널
├── logs/             # 앱 로그
├── pids/             # 앱별 PID 파일
└── modules/          # pm2-logrotate 등 모듈

# 경로 변경 (여러 PM2 인스턴스 격리가 필요할 때)
export PM2_HOME=/opt/pm2-home
pm2 start app.js

                    ┌──────────────────────────────┐
  클라이언트 요청 ────▶│  Primary (PM2 데몬 내부)        │
                    │  :3000 소켓을 실제로 listen      │
                    └────┬─────────┬─────────┬─────┘
                  라운드로빈  │         │         │
                         ▼         ▼         ▼
                    ┌────────┐┌────────┐┌────────┐
                    │Worker 0││Worker 1││Worker 2│
                    └────────┘└────────┘└────────┘

pm2 start app.js -i max    # CPU 코어 수
pm2 start app.js -i 0      # max와 동일
pm2 start app.js -i -1     # 코어 수 - 1 (DB 등 다른 프로세스 몫 남기기)
pm2 start app.js -i 4      # 고정 4개
 
pm2 scale api 6            # 실행 중에 6개로 조정
pm2 scale api +2           # 2개 추가

// ❌ 워커 0에서 로그인 → 다음 요청이 워커 1로 가면 세션 없음
app.use(session({ store: new MemoryStore() }));

// 인스턴스 0번에서만 크론 실행
if (process.env.NODE_APP_INSTANCE === '0') {
  startCronJobs();
}

{ instance_var: 'INSTANCE_ID' }

{
  name: 'legacy',
  script: './legacy.js',
  exec_mode: 'fork',
  instances: 3,
  increment_var: 'PORT',
  env: { PORT: 4000 },   // 4000, 4001, 4002
}

[restart]
  워커 0 kill ─┐
  워커 1 kill ─┼─▶ 모두 새로 시작     ⇒ 짧은 순간 요청 실패 가능
  워커 2 kill ─┘
 
[reload]  (클러스터 모드)
  새 워커 0' 시작 → ready → 기존 워커 0 종료
  새 워커 1' 시작 → ready → 기존 워커 1 종료
  새 워커 2' 시작 → ready → 기존 워커 2 종료   ⇒ 항상 누군가는 요청을 받는 중

const server = app.listen(PORT);
 
let shuttingDown = false;
 
async function shutdown(signal) {
  if (shuttingDown) return;
  shuttingDown = true;
  console.log(`[${signal}] graceful shutdown start`);
 
  // 1. 새 연결 수락 중지 + 진행 중 요청 완료 대기
  server.close(async (err) => {
    try {
      // 2. 외부 리소스 정리
      await db.end();
      await redis.quit();
      console.log('shutdown complete');
      process.exit(err ? 1 : 0);
    } catch (e) {
      console.error(e);
      process.exit(1);
    }
  });
 
  // 3. keep-alive 연결이 server.close()를 막지 않도록 (Node 18.2+)
  server.closeIdleConnections?.();
}
 
process.on('SIGINT', () => shutdown('SIGINT'));
process.on('SIGTERM', () => shutdown('SIGTERM'));  // Docker/systemd 대비

{ kill_timeout: 10000 }  // 10초

// ecosystem.config.js
{
  wait_ready: true,
  listen_timeout: 10000,  // 이 시간 내에 ready가 안 오면 준비된 것으로 간주하고 진행
}

// server.js
async function bootstrap() {
  await db.connect();
  await cache.warmUp();
 
  const server = app.listen(PORT, () => {
    // PM2에게 준비 완료 알림
    if (process.send) process.send('ready');
  });
}
 
bootstrap();

pm2 reload api
   │
   ├─▶ 새 워커 0' spawn
   │      └─ DB 연결, 워밍업 ... process.send('ready')
   │
   ├─▶ (ready 수신) 기존 워커 0 에 SIGINT
   │      └─ server.close() → 진행 중 요청 완료 → exit(0)
   │      └─ kill_timeout 초과 시 SIGKILL
   │
   ├─▶ 새 워커 1' spawn ... (반복)
   ▼
 완료: 요청 유실 0

pm2 sendSignal SIGUSR2 api   # 앱에 임의 시그널 전송 (설정 리로드 등)