PM2 ecosystem 파일이란?
PM2는 Node.js 프로세스 관리자로 무중단 재시작, 클러스터 모드, 자동 재시작, 로그 관리, 모니터링까지 제공합니다. pm2 start app.js처럼 명령행으로도 시작할 수 있지만, 여러 앱·환경·옵션을 다루려면 ecosystem.config.js 파일을 두는 것이 표준입니다.
이 파일에는 앱 배열(apps: [...])을 정의하고 각각의 name, script, instances, env, watch, cron_restart 등을 적습니다. 그러면 pm2 start ecosystem.config.js로 모든 앱을 한 번에 띄우고, --env production 같은 옵션으로 환경별 설정을 전환할 수 있습니다.
주요 옵션
- name: PM2 상에서의 식별자
- script: 실행할 파일 (server.js 등)
- instances: 인스턴스 수 (숫자 또는 'max')
- exec_mode: 'cluster' 또는 'fork'
- max_memory_restart: 메모리 초과 시 재시작
- cron_restart: cron 스타일 정기 재시작
- env / env_production / env_staging: 환경별 변수
자주 묻는 질문 (FAQ)
Q. cluster 모드와 fork 모드의 차이는?
A. cluster는 Node.js의 cluster 모듈을 활용해 CPU 코어 수만큼 워커를 만들어 부하분산합니다. fork는 단일 프로세스만 실행합니다. HTTP 서버는 cluster, 단일 스크립트나 CLI 도구는 fork가 적합합니다.
Q. 서버 재부팅 후에도 자동으로 살아나려면?
A. pm2 startup으로 시스템 init 스크립트를 등록하고 pm2 save로 현재 실행 중인 앱 목록을 저장합니다. 그러면 부팅 시 자동 복구됩니다.
Q. 환경별 설정은 어떻게 적용하나요?
A. env_production: { NODE_ENV: 'production' }처럼 정의한 뒤 pm2 start ecosystem.config.js --env production으로 실행하면 그 블록의 값들이 NODE_ENV 등으로 주입됩니다.