배포 (Deployment)

🤔 혹시 이런 경험 있나요?

AI의 도움으로 멋진 웹 앱을 완성했습니다. 내 컴퓨터에서 localhost:3000으로 접속하면 잘 돌아갑니다. 그런데 친구에게 보여주고 싶어서 URL을 보냈더니... 접속이 안 됩니다. 당연합니다. localhost는 말 그대로 내 컴퓨터에서만 작동하니까요. 이 앱을 세상에 공개하려면 배포(Deployment)가 필요합니다.

🏠 localhost에서 인터넷으로

배포를 이해하려면 먼저 개발 환경과 운영 환경의 차이를 알아야 합니다.

배포란 결국 "내 코드를 인터넷에 연결된 서버에 올려서, 24시간 돌아가게 만드는 것"입니다.

🚀 배포 플랫폼: 어디에 올릴까요?

과거에는 서버를 직접 사거나 임대해야 했지만, 지금은 클릭 몇 번으로 배포할 수 있는 플랫폼이 많습니다.

프론트엔드 + 서버리스 함수

백엔드 / 풀스택

바이브코딩 초보자에게는 Vercel을 가장 추천합니다. GitHub 저장소를 연결하면 코드를 푸시할 때마다 자동으로 배포됩니다.

📝 배포의 기본 과정

Vercel을 예로 들면, 배포는 생각보다 간단합니다.

이후에는 코드를 수정하고 git push만 하면 자동으로 재배포됩니다. 이것을 CI/CD(지속적 통합/지속적 배포)라고 합니다.

🌐 도메인: 나만의 주소 연결하기

배포하면 myapp.vercel.app 같은 기본 주소가 생깁니다. 하지만 실제 서비스라면 myapp.com 같은 커스텀 도메인을 사용하고 싶을 것입니다.

대부분의 배포 플랫폼이 도메인 연결 가이드를 제공하므로, AI에게 "Vercel에 커스텀 도메인 연결하는 방법 알려줘"라고 물어보면 됩니다.

🔒 환경 변수: 배포 환경에서의 비밀 관리

개발할 때 .env 파일에 저장해둔 API 키와 DB 비밀번호는 배포 환경에서 별도로 설정해야 합니다. .env 파일은 GitHub에 올라가지 않으므로, 배포 플랫폼의 환경 변수 설정에서 직접 입력해야 합니다.

이 단계를 빠뜨리면 배포 후 "환경 변수를 찾을 수 없습니다" 에러가 발생합니다. 배포 후 에러가 나는 가장 흔한 원인 중 하나이므로 꼭 확인하세요.

⚠️ 바이브코딩할 때 흔한 배포 실수

1. 환경 변수를 배포 플랫폼에 설정하지 않음

로컬에서는 잘 되는데 배포하면 에러가 나는 1순위 원인입니다. 배포 전에 .env 파일의 모든 변수를 배포 플랫폼에도 등록했는지 확인하세요.

2. 빌드 에러를 무시하고 배포 시도

npm run build를 로컬에서 먼저 실행해보세요. 여기서 에러가 나면 배포도 실패합니다. AI에게 빌드 에러 메시지를 그대로 보여주면 해결 방법을 알려줍니다.

3. 데이터베이스 연결 설정 누락

로컬 DB(localhost:5432)와 운영 DB는 다릅니다. Supabase, Neon 같은 클라우드 DB 서비스를 사용하고, 배포 환경의 DATABASE_URL을 올바르게 설정해야 합니다.

💼 배포 지식이 쓰이는 실제 상황

만든 페이지를 팀에 공유해야 할 때

AI로 이벤트 페이지를 완성하고 팀 채팅방에 localhost:3000 주소를 올리면 아무도 열 수 없습니다. localhost는 내 컴퓨터 안에서만 통하는 주소이기 때문입니다. Vercel에 배포해서 myapp.vercel.app 같은 공개 URL을 만들어야 비로소 팀의 피드백을 받을 수 있습니다.

캠페인용 주소를 연결할 때

event.회사이름.com 같은 주소로 캠페인 페이지를 열고 싶다면, 배포된 앱에 도메인을 연결하는 DNS 설정이 필요합니다. 이 과정을 알면 "CNAME 레코드를 추가해달라"는 요청이 무슨 뜻인지 이해되고, 도메인 담당자와의 소통이 빨라집니다. 도메인 구매와 연결의 전체 과정은 도메인과 셀프호스팅 클래스에서 다룹니다.

배포 후 특정 기능만 안 될 때

로컬에서는 잘 되던 로그인이나 AI 기능이 배포 후에만 실패한다면, 가장 먼저 환경 변수 등록 여부를 확인하는 것이 순서입니다. .env 파일은 GitHub에 올라가지 않으므로, Vercel 대시보드에 같은 값을 등록하지 않으면 앱이 API 키를 찾지 못합니다. 이 원인 하나만 알아도 배포 문제의 상당수를 스스로 걸러낼 수 있습니다.

📋 30초 요약

1. 배포는 내 컴퓨터의 프로젝트를 인터넷에 공개하는 과정입니다. Vercel, Netlify, Railway 같은 플랫폼을 사용하면 클릭 몇 번으로 가능합니다.

2. GitHub에 코드를 올리고 배포 플랫폼을 연결하면, 코드 수정 시 자동으로 재배포됩니다. 이것을 CI/CD라고 합니다.

3. 배포 환경에는 환경 변수를 별도로 설정해야 합니다. 로컬에서 되는데 배포 후 안 되면, 환경 변수 설정을 가장 먼저 확인하세요.