앱을 만들었어요. 내 컴퓨터에서 잘 작동해요. 그런데 친구한테 보여주려고 하니까 “어떻게 접속해요?”라는 질문에 대답을 못해요. 배포란 내 컴퓨터에서만 돌아가는 앱을 인터넷을 통해 누구나 접근할 수 있게 만드는 과정이에요.
배포가 왜 필요한가요
내 컴퓨터에서 앱을 실행하면 localhost:3000 같은 주소로 접근해요. 이 주소는 내 컴퓨터 안에서만 유효해요. 외부에서 접근하려면 인터넷에 연결된 서버에서 앱이 실행되고 있어야 해요.
배포는 크게 두 가지를 의미해요. 첫째, 앱 코드를 서버로 옮기는 것. 둘째, 그 서버에서 앱을 실행하는 것. 이 두 과정이 완료되면 인터넷 어디서나 접근할 수 있는 URL이 생겨요.
배포 과정의 흐름
일반적인 배포 흐름은 이렇게 돼요.
1. 개발 완료된 코드를 GitHub에 푸시해요
2. 배포 서비스(Vercel, Netlify 등)가 GitHub 변경을 감지해요
3. 배포 서비스가 코드를 빌드해요 (개발용 코드를 실제 서비스용으로 변환)
4. 빌드된 파일을 서버에 배포해요
5. 도메인 주소로 접근 가능해져요
현대적인 배포 서비스들은 이 과정을 자동화해줘요. GitHub에 코드를 올리면 나머지는 자동으로 처리돼요.
바이브코더에게 맞는 배포 서비스
배포 서비스는 여러 가지가 있어요. 처음 시작하는 분들에게는 이 두 가지를 추천해요.
Vercel: Next.js를 만든 회사가 운영하는 배포 서비스예요. Next.js 프로젝트라면 설정이 거의 없어요. GitHub 저장소를 연결하면 코드를 올릴 때마다 자동 배포돼요. 무료 플랜으로 충분히 시작할 수 있어요.
Netlify: React, Vue 같은 프론트엔드 프로젝트에 최적화된 서비스예요. 마찬가지로 GitHub 연결만 하면 자동 배포가 돼요.
API가 무엇인지 이해하면, 백엔드 서버가 필요한 앱은 배포 방법이 조금 달라진다는 것도 알 수 있어요.
Vercel로 배포하는 실제 과정
- GitHub에 코드를 올려요 (git push)
- vercel.com에서 “New Project” → GitHub 저장소 선택
- “Deploy” 버튼 클릭 → 2~3분 안에 배포 완료
- vercel.app 주소로 접속해서 확인
코드를 수정해서 GitHub에 올리면 자동으로 새 버전이 배포돼요. 별도 서버 관리 없이 이 사이클만 반복하면 됩니다.
배포 후 확인해야 할 것들
배포가 됐다고 끝이 아니에요. 배포된 환경에서 직접 테스트해야 해요. 내 컴퓨터에서는 잘 됐는데 배포 후에 안 되는 경우가 있거든요. 주로 환경변수(API 키 같은 것들) 설정이 빠졌거나, 배포 환경에서 지원하지 않는 기능을 쓴 경우예요.
환경변수란 무엇인가요
개발할 때는 API 키 같은 민감한 정보를 .env 파일에 저장해요. 이 파일은 GitHub에 올리지 않아요(올리면 안 돼요). 배포할 때는 이 값들을 배포 서비스의 환경변수 설정에 따로 입력해줘야 해요. 예를 들어 데이터베이스 비밀번호나 API 키는 코드에 직접 쓰면 안 돼요. Vercel 대시보드의 Settings → Environment Variables에 KEY=VALUE 형식으로 등록해두면, 코드에서는 process.env.KEY로 안전하게 읽을 수 있어요.
배포는 처음엔 복잡해 보이지만 한 번 경험하고 나면 다음부터는 금방 할 수 있어요. 특히 Vercel + GitHub 조합은 바이브코더에게 가장 부담 없는 시작점이에요.
댓글 0