배포

배포는 GitHub 에 올린 변경을 실서비스(프로덕션) 에 반영하는 일입니다. 개발 서버(내가 확인하는 곳)와 프로덕션(고객이 쓰는 곳)은 별개라, 개발이 끝나고 GitHub 에 올린 뒤 배포해야 고객 화면에 반영됩니다.

전제: 앞 강의(GitHub 업로드)로 변경을 GitHub 에 올려 두었을 것.

배포하려는 그 프로젝트 안(src) 에서 Claude Code 를 켭니다. gildong 은 본인 계정 이름입니다.

# 🖥️ 서버 터미널
gildong@ip-172-31-39-132:~$ cd ~/my_project/src
gildong@ip-172-31-39-132:~/my_project/src$ claude

gildong 계정으로 배포해줘

배포는 반드시 본인 계정 이름으로 합니다. 누가 언제 무엇을 배포했는지 기록으로 남기기 위해서입니다.

배포 중에 데이터베이스 변경(마이그레이션)이 있으면 되돌리기 어려운 작업이라 한 번 멈추고 목록을 보여 주며 물어봅니다. 목록을 확인하고 진행할지 답합니다(y).

이후 배포가 끝나면 정상 동작 확인(헬스체크) 까지 하고 프로덕션 주소를 알려 줍니다.

• 핵심 정리: 프로젝트 세션에서 {본인 계정} 계정으로 배포해줘 로 실서비스에 배포하고, 마이그레이션 확인 질문에 답했습니다.
• 주의 사항: ① 본인 계정으로 배포합니다(공유 계정 금지, 추적을 위해). ② 배포는 그 프로젝트 세션에서 실행합니다(다른 프로젝트 세션에서 하면 엉뚱한 곳으로 갑니다). ③ GitHub 에 안 올린 변경은 반영되지 않습니다.
• 다음 시간: 배포 확인.

배포가 끝나면 알려 준 프로덕션 주소(https://my-project.popupstudio.ai 형태)를 브라우저에서 엽니다. 방금 배포한 변경이 화면에 보이면 배포가 정상입니다.

개발 서버 주소(...-dev.popupstudio.ai)와 프로덕션 주소(...popupstudio.ai)는 다릅니다. 고객이 쓰는 곳은 프로덕션 주소입니다.

화면이 안 뜨거나 이상하면 직접 고치려 하지 말고, 다음을 그대로 캡처해 담당자(또는 팀)에게 알립니다.

• 어떤 주소에서
• 무엇을 하려 했는데
• 어떤 화면·메시지가 나왔는지

배포 중 문제가 있으면 스스로 멈추고 로그 위치를 알려 줍니다. 그 내용도 함께 전달합니다.

• 핵심 정리: 프로덕션 주소를 열어 배포 결과를 확인했습니다. 문제가 있으면 상황을 그대로 캡처해 알립니다.
• 주의 사항: 개발 서버 주소와 프로덕션 주소를 혼동하지 마세요. 고객이 보는 곳은 프로덕션 주소입니다.
• 다음 시간: 환경 준비부터 배포까지 배웠습니다. 이제 종합 실습에서 실제 프로젝트로 전 과정을 한 바퀴 돌아봅니다.