콘텐츠로 이동

Node.js Runtime Short Runbook

이 문서를 볼 때

  • Node.js API/Express 서비스를 운영 서버에 올릴 때
  • PM2 기반 실행, 로그, 보안, Nginx 연동을 점검할 때
  • /home 작업 경로와 /var/www 실행 경로를 분리할 때

먼저 필요한 입력값

  • 서비스명과 도메인
  • 운영 사용자/그룹
  • Node.js major version
  • 앱 listen host/port
  • PM2 process name
  • 실행 파일 또는 ecosystem config 경로
  • Nginx upstream 경로
  • 로그 저장 방식
  • DB/Redis 연결 방식

작업 순서

  1. 운영 구조 확인: Nginx 뒤에서만 동작
  2. NodeSource 기반 전역 Node.js 설치
  3. 작업 경로와 운영 실행 경로 분리
  4. 앱 빌드/검증은 작업 경로에서 수행
  5. release/current 구조로 운영 경로 배치
  6. PM2 ecosystem config 기준 실행
  7. PM2 startup과 systemd 연동
  8. Nginx reverse proxy와 SELinux 확인
  9. Winston, DB ORM, 보안 기준 확인
  10. Do Not Do List 위반 여부 확인

중단 조건

  • 운영 서버에서 nvm 사용을 요구
  • Node.js 포트를 외부에 직접 노출하려 함
  • /var/www/.../current에서 npm install 또는 개발 작업을 하려 함
  • PM2 없이 node index.js 또는 npm run start로 장기 실행하려 함
  • SELinux/firewall 문제 해결을 위해 비활성화를 요구

검증 명령

node -v
npm -v
which node
which pm2
pm2 status
pm2 describe <process-name>
systemctl status pm2-<user>.service
ss -lntup | grep node
nginx -t
curl -I https://example.com

상세 문서