PM2로 Next.js 프로덕션 운영하기 — 무중단 배포와 모니터링

# PM2 전역 설치

npm install -g pm2

# Next.js 앱 시작 (기본)
pm2 start npm --name "my-app" -- start

# 상태 확인
pm2 status

# 실시간 로그 확인
pm2 logs my-app --lines 50

ecosystem.config.js

module.exports = {
  apps: [
    {
      name: "main-site",
      script: "node_modules/.bin/next",
      args: "start",
      cwd: "/home/deploy/main-site",
      instances: 1,          // Next.js는 fork 모드 권장
      exec_mode: "fork",
      env: {
        NODE_ENV: "production",
        PORT: 3000,
      },
      max_memory_restart: "500M",
      error_file: "./logs/error.log",
      out_file: "./logs/output.log",
      merge_logs: true,
      log_date_format: "YYYY-MM-DD HH:mm:ss",
    },
    {
      name: "admin-site",
      script: "node_modules/.bin/next",
      args: "start",
      cwd: "/home/deploy/admin-site",
      instances: 1,
      exec_mode: "fork",
      env: {
        NODE_ENV: "production",
        PORT: 3001,
      },
      max_memory_restart: "300M",
    },
  ],
};

# ecosystem 파일로 시작/관리

# 전체 앱 시작
pm2 start ecosystem.config.js

# 특정 앱만 시작
pm2 start ecosystem.config.js --only main-site

# 설정 변경 후 적용
pm2 reload ecosystem.config.js

# 배포 시 명령어 비교

# restart: 기존 프로세스 kill → 새 프로세스 start
# 다운타임 발생 (보통 2~5초)
pm2 restart my-app

# reload: 새 프로세스 start → 준비 완료 후 → 기존 프로세스 kill
# 다운타임 0초 (cluster 모드에서 완벽 동작)
pm2 reload my-app

# fork 모드에서는 gracefulReload 옵션 활용
pm2 reload my-app --update-env

# pm2-logrotate 모듈 설치 및 설정

# logrotate 모듈 설치
pm2 install pm2-logrotate

# 설정 변경
pm2 set pm2-logrotate:max_size 10M     # 파일당 최대 크기
pm2 set pm2-logrotate:retain 7         # 보관 파일 수
pm2 set pm2-logrotate:compress true    # 이전 로그 gzip 압축
pm2 set pm2-logrotate:dateFormat YYYY-MM-DD_HH-mm
pm2 set pm2-logrotate:rotateModule true

# 로그 경로 확인
pm2 logs --nostream   # 로그 파일 위치만 표시

# systemd 서비스 등록

# 1. startup 스크립트 생성
pm2 startup systemd
# 출력되는 sudo 명령어를 복사해서 실행

# 2. 현재 프로세스 목록 저장
pm2 save

# 3. 서버 재부팅 후 자동 복원 확인
sudo reboot
# ... 재부팅 후 ...
pm2 status   # 이전 프로세스들이 자동으로 실행됨

# systemd 서비스 상태 확인
systemctl status pm2-deploy

# 유용한 PM2 모니터링 명령어

# 대시보드 (CPU, 메모리, 로그 실시간 확인)
pm2 monit

# 프로세스별 상세 정보
pm2 show my-app

# 메모리 사용량 변화 추적
pm2 show my-app | grep memory

# 재시작 횟수 확인 (비정상 재시작이 많으면 문제)
pm2 show my-app | grep restarts