[12] 배포 안정화 & 운영 준비- PM2로 백그라운드 관리

1. EC2 인스턴스 준비 

2025.06.12 - [🇰🇷 한국어 (Korean)/AWS] - [9] EC2 인스턴스 연결

2. Node.js & 애플리케이션 설치
  2.1 Node.js 설치 (NodeSource)
  2.2 프로젝트 초기화 및 Express 설치
  2.3 package.json 설정
  2.4 index.js 작성
  2.5 테스트 실행

2025.06.17 - [🇰🇷 한국어 (Korean)/AWS] - [11] AWS EC2에 Node.js & 애플리케이션 설치하기

3. PM2로 백그라운드 실행 

4. Nginx 리버스 프록시 설정
   4.1 설치
   4.2 설정 파일 /etc/nginx/conf.d/my-node-app.conf 생성
   4.3 검증 & 재시작
   4.4 확인


5. 도메인(Route 53) 연결
  5.1 Route 53 → 호스팅 영역(Hosted zones) → trill-server.com 선택
  5.2 레코드 생성(Create record)
  5.3 저장 후 dig +short trill-server.com → IP 확인


6. HTTPS 적용 (Let’s Encrypt)
  6.1 보안 그룹: HTTPS(443) → 0.0.0.0/0 추가
  6.2 Certbot 설치
  6.3 인증서 발급 & 설치
  6.4 자동 갱신
  6.5 확인

 

---

목차에서 

3.PM2로 백그라운드 실행를 하려고 한다.

 

 

3.  PM2로 백그라운드 관리

< PM2로 백그라운드 실행을 하는 목적 >
PM2(Process Manager 2)를 쓰는 이유는, 
단순히 node index.js & 처럼 백그라운드로 띄우는 것만으로는 부족한 여러 운영상의 문제를 해결해 주기 때문이다.



1. 프로세스 죽음 방지 & 자동 재시작
서버에서 메모리 누수나 예기치 않은 에러로 앱이 종료될 수 있는데,
PM2가 “죽으면 바로 다시 띄워” 주니까 다운타임을 최소화할 수 있다.



2. 서버 재부팅 시 자동 기동
단순 백그라운드 실행(&)은 시스템 재부팅 시 사라지지만,
pm2 startup + pm2 save 명령을 한 번만 해 두면 OS가 켜질 때 PM2 데몬이 자동으로 뜨고, 
저장된 프로세스들을 다시 시작해 준다.



3. 로그 관리 & 모니터링
PM2는 stdout/stderr 로그를 각각 파일로 수집해 주고,
pm2 logs 로 실시간 스트림 조회가 가능하며,
pm2 monit 로 CPU·메모리 사용량 같은 메트릭도 확인할 수 있다.



4. 클러스터 모드 & 로드 밸런싱
멀티 코어 머신에서 -i max 옵션으로 여러 프로세스를 띄워
PM2 내장 로드밸런서로 요청을 분산 처리하게 할 수 있다.



5. 운영 자동화 편의
- pm2 reload all 로 무중단 재시작
- pm2 scale my-app 4 로 인스턴스 수 조정(클러스터 모드)
- 배포 스크립트나 CI/CD에서 쓰기 편리




요약:
PM2는 “단순 백그라운드 실행”이 가진 한계를 넘어,
- 프로세스 가용성 보장
-  재부팅·오류 시 자동 복구
- 로그·모니터링 지원
-  클러스터링·무중단 재시작
같은 
“진짜 프로덕션 운영”
에 꼭 필요한 기능들을 제공한다.

 

 

아래의 코드를 입력한다.

sudo npm install -g pm2
pm2 start index.js --name my-node-app
pm2 startup systemd
# 복붙 스크립트 실행 → pm2 save

 

오류 발생!

오류부터 해결하고 가자!

 

---

2.1 문제 발생- 해결과정.

 

 

 

[ec2-user@ip-172-31-44-167 ~]$ sudo npm install -g pm2
pm2 start index.js --name my-node-app
pm2 startup systemd

added 135 packages in 8s

13 packages are looking for funding
  run `npm fund` for details
npm notice
npm notice New major version of npm available! 10.9.2 -> 11.4.2
npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.4.2
npm notice To update run: npm install -g npm@11.4.2
npm notice

                        -------------

__/\\\\\\\\\\\\\____/\\\\____________/\\\\____/\\\\\\\\\_____
 _\/\\\/////////\\\_\/\\\\\\________/\\\\\\__/\\\///////\\\___
  _\/\\\_______\/\\\_\/\\\//\\\____/\\\//\\\_\///______\//\\\__
   _\/\\\\\\\\\\\\\/__\/\\\\///\\\/\\\/_\/\\\___________/\\\/___
    _\/\\\/////////____\/\\\__\///\\\/___\/\\\________/\\\//_____
     _\/\\\_____________\/\\\____\///_____\/\\\_____/\\\//________
      _\/\\\_____________\/\\\_____________\/\\\___/\\\/___________
       _\/\\\_____________\/\\\_____________\/\\\__/\\\\\\\\\\\\\\\_
        _\///______________\///______________\///__\///////////////__


                          Runtime Edition

        PM2 is a Production Process Manager for Node.js applications
                     with a built-in Load Balancer.

                Start and Daemonize any application:
                $ pm2 start app.js

                Load Balance 4 instances of api.js:
                $ pm2 start api.js -i 4

                Monitor in production:
                $ pm2 monitor

                Make pm2 auto-boot at server restart:
                $ pm2 startup

                To go further checkout:
                http://pm2.io/


                        -------------

[PM2] Spawning PM2 daemon with pm2_home=/home/ec2-user/.pm2
[PM2] PM2 Successfully daemonized
[PM2][ERROR] Script not found: /home/ec2-user/index.js
[PM2] Init System found: systemd
[PM2] To setup the Startup Script, copy/paste the following command:
sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u ec2-user --hp /home/ec2-user
[ec2-user@ip-172-31-44-167 ~]$

 

에러 발생 이유 :

pm2 start index.js를 하려면 반드시 “index.js” 파일이 있는 프로젝트 디렉터리에서 실행해야 한다. 

지금은 홈 디렉터리(~)에 있기 때문에 /home/ec2-user/index.js를 찾으려다가 없다고 에러가 난것이다.

 

해결 과정 :

제대로 PM2로 앱 띄우기

1. 프로젝트 폴더로 이동

cd ~/my-node-app

 

 2. PM2로 서버 시작

pm2 start index.js --name my-node-app

 

 

3. 실행중인 프로세스 확인

pm2 ls

 

PM2로 앱이 잘 올라간 걸 확인하였다.

오류 해결!

---

 

 서버 재부팅 시에도 자동 기동 설정

1. PM2 startup 스크립트 생성

pm2 startup systemd

 

 

 2. 출력된 명령어 복사→실행

sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u ec2-user --hp /home/ec2-user

화면에 보이는 것 처럼 PM2를 systemd에 등록했으니, 남은 건 “프로세스 목록을 저장”(pm2 save) 하고, 리버스 프록시(Nginx) 설정으로 외부 포트(80/443)와 연결하는 작업이다

 

   3. 현재 프로세스 목록 저장

pm2 save

 

 

이제 “외부(80/443 포트) →  Node.js 앱(3000 포트)” 경로를 만들어 주기만 하면 진짜 서비스처럼 동작한다.

 

다음 단계는 Nginx를 리버스 프록시로 세팅하는 작업이다.