콘텐츠로 이동

Operation Short Runbook

이 문서를 볼 때

  • PM2 기반 운영 배포 표준을 적용할 때
  • release directory와 current symlink 구조를 만들 때
  • lock, rollback, PM2 reload 기준을 확인할 때

먼저 필요한 입력값

  • 서비스명
  • 운영 사용자/그룹
  • deploy base
  • release id/package version
  • PM2 process name
  • ecosystem config 위치
  • 보관할 release 개수

작업 순서

  1. /var/www/<service> 표준 구조 확인
  2. deploy lock 파일 준비
  3. 신규 release directory 생성
  4. 산출물 배치와 필수 파일 검증
  5. shared 파일 연결
  6. runtime dependency 검증
  7. current symlink를 atomic하게 전환
  8. PM2 reload/restart/start
  9. pm2 save --force
  10. 오래된 release 정리
  11. rollback 가능성 확인

중단 조건

  • current가 symlink가 아님
  • 동시 배포 lock을 사용할 수 없음
  • rollback 가능한 이전 release가 없음
  • PM2 process name과 ecosystem config가 불일치

검증 명령

readlink -f /var/www/<service>/current
ls -dt /var/www/<service>/releases/*
pm2 status
pm2 describe <process-name>
pm2 save --force

상세 문서