배포 매뉴얼
전체 목차00 · 전체 개요와 사전 준비
Chapter 00

전체 개요와 사전 준비

최종 확인일 2026-11-04 읽는 시간 약 6분 시작하기 · 첫 배포까지

목표#

  • GitHub와 Vercel이 각각 어떤 역할을 하고, 어떻게 연결되어 배포가 이루어지는지 이해합니다.
  • 매뉴얼을 따라 하는 데 필요한 계정과 도구를 미리 준비합니다.

사전 조건#

  • 인터넷에 연결된 PC (Windows, macOS, Linux 모두 가능)
  • 터미널(Windows는 PowerShell, macOS/Linux는 Terminal)을 열고 명령어를 입력할 수 있는 정도의 기초 지식

1. GitHub와 Vercel은 각각 무엇을 하나요?#

구분GitHubVercel
역할소스 코드를 저장하고 변경 이력을 관리코드를 빌드해 인터넷에 서비스(호스팅)
하는 일저장소(Repository) 보관, 브랜치·PR 관리빌드 실행, 배포, 도메인·HTTPS 제공
비유설계도 보관소설계도를 받아 건물을 짓고 문을 여는 시공사

두 서비스를 연결하면 GitHub에 코드를 올리는 것만으로 Vercel이 자동으로 빌드하고 배포합니다. 서버를 직접 준비하거나 파일을 업로드할 필요가 없습니다.

참고

빌드(Build) 는 사람이 작성한 소스 코드를 브라우저가 바로 읽을 수 있는 파일(HTML, CSS, JS)로 변환하는 과정입니다. 순수 HTML 사이트처럼 변환할 것이 없으면 빌드 단계는 생략됩니다.

2. 전체 배포 흐름#

로컬 PC코드 작성
git push
GitHub 저장소
변경 알림
Vercel빌드
어느 브랜치에 push했나요?
main → Production 배포your-project.vercel.app
  1. 로컬 PC에서 코드를 작성하고 GitHub 저장소에 push합니다.
  2. Vercel이 GitHub 저장소의 변경을 감지합니다.
  3. Vercel이 코드를 내려받아 빌드합니다.
  4. 브랜치에 따라 배포 종류가 달라집니다.

    • 기본 브랜치(main): Production(운영) 배포. 실제 사용자가 접속하는 주소가 갱신됩니다.
    • 그 외 브랜치 또는 Pull Request: Preview(미리보기) 배포. 운영 사이트에는 영향을 주지 않고, 별도 URL에서 변경 사항을 확인할 수 있습니다.
팁

Preview 배포 덕분에 "운영 사이트를 망가뜨릴까 봐" 걱정하지 않고 새 기능을 실험할 수 있습니다. 자세한 내용은 6장에서 다룹니다.

3. 알아 두면 좋은 용어#

용어뜻
저장소 (Repository)프로젝트 파일과 변경 이력을 담은 GitHub의 공간
커밋 (Commit)변경 사항을 하나의 단위로 기록하는 것
푸시 (Push)로컬 커밋을 GitHub 저장소로 올리는 것
브랜치 (Branch)원본에 영향을 주지 않고 따로 작업하는 갈래. 기본 브랜치는 보통 main
PR (Pull Request)다른 브랜치의 변경을 main에 합쳐 달라고 요청하는 것
배포 (Deployment)빌드 결과물을 인터넷에서 접속할 수 있게 올리는 것
Production실제 사용자가 보는 운영 배포
Preview확인용 미리보기 배포
환경 변수 (Environment Variable)API 키처럼 코드에 직접 적지 않고 따로 설정하는 값

4. 준비물#

4-1. 계정#

준비물필수 여부비고
GitHub 계정필수https://github.com 에서 무료 가입
Vercel 계정필수2장에서 GitHub 계정으로 가입합니다. 지금 만들지 않아도 됩니다.
중요

Vercel의 무료 요금제(Hobby)는 개인·비상업적 용도로 제공됩니다. 회사 서비스나 수익이 나는 프로젝트라면 유료 요금제(Pro 등)가 필요할 수 있으니 Vercel 요금제 안내를 확인하세요.

4-2. 프로그램#

프로그램필수 여부용도
Git필수코드를 GitHub에 올릴 때 사용
Node.js (LTS 버전)프로젝트에 따라React, Next.js, Vue 등 JavaScript 프레임워크 프로젝트일 때 필요. 순수 HTML이면 없어도 됩니다.
코드 편집기권장예: Visual Studio Code

4-3. 설치 여부 확인#

터미널을 열고 아래 명령어를 입력합니다. 명령어는 PowerShell과 macOS/Linux 터미널에서 동일합니다.

bash
git --version
node --version
npm --version

정상 출력 예시:

output
git version 2.x.x
v22.x.x
10.x.x
참고

버전 숫자는 설치한 시점에 따라 다릅니다. 숫자가 출력되기만 하면 설치된 것입니다.

command not found 또는 인식되지 않습니다 오류가 나오면 해당 프로그램이 설치되지 않은 것입니다.

주의

설치 후에는 터미널을 완전히 닫았다가 다시 열어야 명령어가 인식됩니다.

4-4. Git 사용자 정보 설정 (최초 1회)#

Git을 처음 설치했다면 커밋에 기록될 이름과 이메일을 설정합니다.

bash
git config --global user.name "홍길동"
git config --global user.email "you@example.com"

설정이 잘 되었는지 확인합니다.

bash
git config --global --list
팁

이메일은 GitHub 계정에 등록된 이메일과 같게 설정하면 커밋이 GitHub 프로필에 정상적으로 연결됩니다. 이메일을 공개하고 싶지 않다면 GitHub Settings → Emails에서 제공하는 noreply 주소를 사용할 수 있습니다.

4-5. 배포할 프로젝트#

이미 만든 프로젝트가 있다면 그것을 사용하면 됩니다. 없다면 다음 중 하나로 시작하세요.

  • 가장 간단한 방법: 폴더 하나에 index.html 파일 하나만 만들어도 배포할 수 있습니다.
  • 프레임워크 사용: 예를 들어 Next.js 프로젝트는 아래 명령어로 만들 수 있습니다.

    bash
    npx create-next-app@latest my-app

확인 방법#

다음 항목을 모두 체크했다면 준비가 끝났습니다.

다음 단계#

➡️ 1장. GitHub 저장소 준비: 로컬 프로젝트를 GitHub 저장소에 올립니다.

참고 자료#