hanarang-dashboard/.plans/deploy/deploy-plan.md

배포 계획

환경

• Dev 서버: 10.10.10.169
• 프로세스 관리: PM2
• 리버스 프록시: Nginx (LXC 101)

도메인

서비스	도메인	포트
Frontend	hanarang.nabomhalang.co.kr	3004
Backend	hanarang-api.nabomhalang.co.kr	3005

배포 절차

1. Dev 서버에서 repo pull
2. backend/: npm install → npx prisma migrate deploy → npm run build → PM2 start/restart
3. frontend/: npm install → npm run build → PM2 start/restart
4. Nginx 설정 추가 + reload
5. SSL 인증서 발급 (certbot)

PM2 설정

backend:  pm2 start backend/dist/src/main.js --name hanarang-api --cwd /path/to/hanarang-dashboard --env production
frontend: pm2 start npm --name hanarang-web --cwd /path/to/hanarang-dashboard/frontend -- start -- -p 3004

• backend 엔트리포인트는 실제 Nest 빌드 산출물 기준 backend/dist/src/main.js를 사용해.
• repo 루트에서 실행하면 --cwd를 명시해서 PM2가 올바른 작업 디렉터리를 잡도록 해.

SSH 키 배포

• Dev 서버(10.10.10.169)에서 4자매 서버로 SSH 접속할 수 있도록 키 배포 필요
• 이랑이가 SSH 키 생성 + 각 자매 서버에 authorized_keys 추가