목표#
- GitHub와 Vercel이 각각 어떤 역할을 하고, 어떻게 연결되어 배포가 이루어지는지 이해합니다.
- 매뉴얼을 따라 하는 데 필요한 계정과 도구를 미리 준비합니다.
사전 조건#
- 인터넷에 연결된 PC (Windows, macOS, Linux 모두 가능)
- 터미널(Windows는 PowerShell, macOS/Linux는 Terminal)을 열고 명령어를 입력할 수 있는 정도의 기초 지식
1. GitHub와 Vercel은 각각 무엇을 하나요?#
| 구분 | GitHub | Vercel |
|---|---|---|
| 역할 | 소스 코드를 저장하고 변경 이력을 관리 | 코드를 빌드해 인터넷에 서비스(호스팅) |
| 하는 일 | 저장소(Repository) 보관, 브랜치·PR 관리 | 빌드 실행, 배포, 도메인·HTTPS 제공 |
| 비유 | 설계도 보관소 | 설계도를 받아 건물을 짓고 문을 여는 시공사 |
두 서비스를 연결하면 GitHub에 코드를 올리는 것만으로 Vercel이 자동으로 빌드하고 배포합니다. 서버를 직접 준비하거나 파일을 업로드할 필요가 없습니다.
빌드(Build) 는 사람이 작성한 소스 코드를 브라우저가 바로 읽을 수 있는 파일(HTML, CSS, JS)로 변환하는 과정입니다. 순수 HTML 사이트처럼 변환할 것이 없으면 빌드 단계는 생략됩니다.
2. 전체 배포 흐름#
main → Production 배포your-project.vercel.app- 로컬 PC에서 코드를 작성하고 GitHub 저장소에 push합니다.
- Vercel이 GitHub 저장소의 변경을 감지합니다.
- Vercel이 코드를 내려받아 빌드합니다.
브랜치에 따라 배포 종류가 달라집니다.
- 기본 브랜치(
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 터미널에서 동일합니다.
git --version
node --version
npm --version정상 출력 예시:
git version 2.x.x
v22.x.x
10.x.x버전 숫자는 설치한 시점에 따라 다릅니다. 숫자가 출력되기만 하면 설치된 것입니다.
command not found 또는 인식되지 않습니다 오류가 나오면 해당 프로그램이 설치되지 않은 것입니다.
- Git 설치: https://git-scm.com/downloads
- Node.js 설치: https://nodejs.org (LTS 버전 선택)
설치 후에는 터미널을 완전히 닫았다가 다시 열어야 명령어가 인식됩니다.
4-4. Git 사용자 정보 설정 (최초 1회)#
Git을 처음 설치했다면 커밋에 기록될 이름과 이메일을 설정합니다.
git config --global user.name "홍길동"
git config --global user.email "you@example.com"설정이 잘 되었는지 확인합니다.
git config --global --list이메일은 GitHub 계정에 등록된 이메일과 같게 설정하면 커밋이 GitHub 프로필에 정상적으로 연결됩니다. 이메일을 공개하고 싶지 않다면 GitHub Settings → Emails에서 제공하는 noreply 주소를 사용할 수 있습니다.
4-5. 배포할 프로젝트#
이미 만든 프로젝트가 있다면 그것을 사용하면 됩니다. 없다면 다음 중 하나로 시작하세요.
- 가장 간단한 방법: 폴더 하나에
index.html파일 하나만 만들어도 배포할 수 있습니다. 프레임워크 사용: 예를 들어 Next.js 프로젝트는 아래 명령어로 만들 수 있습니다.
npx create-next-app@latest my-app
확인 방법#
다음 항목을 모두 체크했다면 준비가 끝났습니다.
다음 단계#
➡️ 1장. GitHub 저장소 준비: 로컬 프로젝트를 GitHub 저장소에 올립니다.