PM2 완전 정복 1편 — 프로세스 매니저가 필요한 이유와 첫 실행

node server.js

# 전역 설치
npm install pm2@latest -g
 
# 버전 확인
pm2 -v

// server.js
const http = require('http');
 
const PORT = process.env.PORT || 3000;
 
http.createServer((req, res) => {
  res.end(`hello from pid ${process.pid}\n`);
}).listen(PORT, () => {
  console.log(`listening on ${PORT}`);
});

pm2 start server.js

┌────┬──────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┐
│ id │ name     │ mode    │ ↺       │ status   │ cpu    │ mem  │ user      │ watching │
├────┼──────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┤
│ 0  │ server   │ fork    │ 0       │ online   │ 0%     │ 40mb │ han       │ disabled │
└────┴──────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┘

# 이름 지정
pm2 start server.js --name api
 
# 클러스터 모드로 CPU 코어 수만큼
pm2 start server.js --name api -i max
 
# 스크립트에 인자 전달 (-- 뒤는 앱에 전달됨)
pm2 start server.js --name api -- --port 4000
 
# Node 옵션 전달
pm2 start server.js --node-args="--max-old-space-size=1024"
 
# 타임스탬프 로그
pm2 start server.js --time

pm2 list            # = pm2 ls, pm2 status
pm2 describe api    # 특정 앱 상세 정보 (경로, 로그 위치, 재시작 횟수, 환경 등)
pm2 show api        # describe와 동일
pm2 env 0           # id 0 프로세스의 환경 변수
pm2 jlist           # JSON 출력 (스크립트 연동용)
pm2 prettylist      # 보기 좋은 JSON
pm2 monit           # 터미널 대시보드 (CPU/메모리/로그 실시간)

pm2 stop api        # 중지 (목록에는 남음)
pm2 restart api     # 강제 재시작 (kill → start)
pm2 reload api      # 무중단 재시작 (클러스터 모드에서 의미 있음)
pm2 delete api      # 목록에서 제거
pm2 reset api       # 재시작 카운터 등 메타데이터 초기화
 
# 대상 지정 방법
pm2 restart 0            # id로
pm2 restart api          # 이름으로
pm2 restart all          # 전부
pm2 restart api worker   # 여러 개
pm2 restart /^api-/      # 정규식

pm2 ping    # 데몬 살아있는지 확인
pm2 kill    # 데몬과 모든 프로세스 종료

~/.pm2/logs/
├── api-out.log      # stdout (console.log)
└── api-error.log    # stderr (console.error)

pm2 logs                 # 전체 앱 실시간 로그
pm2 logs api             # 특정 앱
pm2 logs api --lines 200 # 최근 200줄부터
pm2 logs api --err       # 에러 로그만
pm2 logs --json          # JSON 형식
pm2 flush                # 모든 로그 파일 비우기
pm2 flush api            # 특정 앱만
pm2 reloadLogs           # 로그 파일 핸들 다시 열기 (외부 로테이션 후 사용)