GitHub + Vercel 초보자를 위한 단계별 배포 가이드
git push 한 번으로
git push 한 번으로
내 서비스를 세상에
GitHub 저장소를 Vercel에 연결하면 서버를 직접 준비하지 않아도 코드를 올릴 때마다 자동으로 배포됩니다. 저장소 준비부터 첫 배포, 환경 변수, 커스텀 도메인까지 차례대로 따라 해 보세요.
How it works
배포는 이렇게 이루어집니다
한 번만 연결해 두면, 이후에는 평소처럼 코드를 push하는 것이 곧 배포입니다. 서버 설정도, 파일 업로드도 필요 없습니다.
01
코드 push
로컬에서 작업한 코드를 git push로 GitHub 저장소에 올립니다.
02
자동 빌드
Vercel이 변경을 감지해 코드를 내려받고 빌드합니다. 설정은 대부분 자동입니다.
03
서비스 공개
my-app.vercel.app 같은 주소로 누구나 접속할 수 있고, HTTPS도 자동입니다.
main 브랜치에 push → Production
실제 사용자가 보는 운영 사이트가 바로 갱신됩니다.
다른 브랜치 · PR → Preview
운영 사이트는 그대로 두고, 별도 주소에서 미리 확인합니다.
Before you start
시작하기 전에
아래 항목을 확인하면 바로 따라 할 수 있습니다. 설치 방법과 확인 명령어는 0장에서 자세히 안내합니다.
이런 분께 맞습니다
- Git으로 commit·push는 해 봤지만 배포는 처음인 분
- 만든 웹 프로젝트(HTML, React, Next.js 등)를 인터넷에 공개하고 싶은 분
- push만 하면 자동으로 배포되는 환경을 만들고 싶은 분
준비물
- GitHub 계정
- Git 설치 —
git --version으로 확인 - Node.js LTS 프레임워크 사용 시
- 배포할 프로젝트 —
index.html하나만 있어도 OK
Vercel 계정은 2장에서 GitHub 계정으로 가입합니다. 무료(Hobby) 요금제는 개인·비상업적 용도입니다.
Table of contents
목차
처음이라면 0장부터 3장까지 순서대로 진행하면 첫 배포가 완료됩니다. 이후 장은 필요할 때 골라 읽으세요.
시작하기첫 배포까지
설정빌드와 환경 변수
Quick look
빠른 맛보기
1장에서 실행할 명령어입니다. 이 과정을 마친 뒤 Vercel에서 저장소를 Import하고 Deploy를 누르면 첫 배포가 끝납니다.
# 1. 로컬 프로젝트를 Git 저장소로 만들고 첫 커밋 $ git init $ git add . $ git commit -m "Initial commit" # 2. GitHub 저장소와 연결하고 push $ git branch -M main $ git remote add origin https://github.com/<USER>/<REPO>.git $ git push -u origin main