← 목록으로
웹 개발

Vercel에 블로그 배포하기 — 10분 만에 내 사이트 만들기

👁 191

배포란 뭘까?

지금까지 우리가 만든 블로그는 내 컴퓨터에서만 볼 수 있었습니다. 배포(Deploy)란 이 블로그를 인터넷에 올려서 전 세계 누구나 접속할 수 있게 하는 것을 말합니다.

쉽게 말하면, 내 컴퓨터에 있는 요리를 식당에 내놓는 것과 같습니다.

Vercel을 선택한 이유

배포 플랫폼은 여러 가지가 있지만, Next.js 프로젝트라면 Vercel이 최선의 선택입니다.

  • Next.js를 만든 회사가 운영하는 플랫폼입니다. 궁합이 완벽합니다.
  • 개인 프로젝트는 완전 무료입니다.
  • GitHub에 코드를 올리면 자동으로 배포됩니다.
  • 글로벌 CDN으로 전 세계 어디서나 빠르게 접속됩니다.
  • HTTPS(SSL)가 자동으로 적용됩니다.

배포 과정 (진짜 10분이면 됩니다)

Step 1: GitHub에 코드 올리기

먼저 프로젝트 코드를 GitHub 저장소에 올려야 합니다. GitHub 계정이 없다면 먼저 가입하세요. VS Code의 터미널에서 git 명령어로 코드를 올리거나, GitHub Desktop 앱을 사용하면 됩니다.

Step 2: Vercel 가입 및 GitHub 연동

vercel.com에 접속해서 GitHub 계정으로 로그인합니다. 그러면 자동으로 GitHub 저장소 목록이 나타납니다.

Step 3: 프로젝트 가져오기

블로그 저장소를 선택하고 "Import" 버튼을 클릭합니다. 환경 변수(Supabase URL, API Key 등)를 입력하는 화면이 나오면, .env.local 파일의 내용을 하나씩 추가합니다.

Step 4: 배포!

"Deploy" 버튼을 클릭하면 Vercel이 자동으로 빌드하고 배포합니다. 약 1~2분 후에 프로젝트명.vercel.app 주소로 내 블로그에 접속할 수 있습니다.

커스텀 도메인 연결하기

vercel.app 도메인도 좋지만, 자체 도메인을 쓰면 더 전문적으로 보입니다. 도메인 구매 사이트(가비아, Namecheap 등)에서 도메인을 구매한 후, Vercel 프로젝트 설정에서 도메인을 추가하면 됩니다.

DNS 설정에서 Vercel이 안내하는 CNAME 또는 A 레코드를 추가하면 보통 5~30분 내에 연결됩니다.

자동 배포의 마법

Vercel의 가장 좋은 점 중 하나는 자동 배포입니다. GitHub에 코드를 push하면 Vercel이 자동으로 감지하고 새 버전을 배포합니다. 별도의 작업이 필요 없습니다.

심지어 브랜치별로 미리보기 배포(Preview Deployment)도 자동으로 만들어줍니다. 새 기능을 테스트할 때 매우 유용합니다.

마치며

배포까지 완료하면 진짜 내 블로그가 인터넷에 살아 있는 것을 확인하는 순간이 옵니다. 그 순간의 기쁨은 직접 경험해보지 않으면 모릅니다. 내가 만든 것이 전 세계에 공개되는 경험, 정말 특별합니다.

다음 글에서는 블로그에 다국어 지원(한국어/영어)을 추가하는 방법을 공유할게요!

로컬 개발 환경(`localhost:3000`) vs 프로덕션 배포 환경 비교

내 컴퓨터에서 npm run dev로 띄운 웹사이트는 나 혼자만 볼 수 있는 테스트 서버입니다. 이를 전 세계 누구나 도메인 주소로 24시간 접속할 수 있게 하려면 클라우드 호스팅 플랫폼에 프로덕션 빌드(Production Build)를 배포해야 합니다. Next.js 제작사인 Vercel과 글로벌 엣지 네트워크인 Cloudflare Pages/Workers의 특징을 비교해 보겠습니다.

비교 항목 로컬 개발 서버 (`next dev`) Vercel (Hobby 무료 플랜) Cloudflare Workers / Pages
코드 최적화 여부 최적화 안 됨 (디버깅 및 실시간 수정 중심) 코드 압축(Minification), 이미지 자동 WebP 변환, 정적 캐싱 글로벌 300개 이상 엣지 로케이션에서 초저지연 응답
무료 트래픽 한도 본인 PC 내부에서만 접속 가능 월 100GB 대역폭 제공 정적 에셋 대역폭 무제한 무료 (일 10만 건 Worker 요청 무료)
환경변수 관리 프로젝트 폴더 내 `.env.local` 파일 참조 Vercel 대시보드 → Settings → Environment Variables에 등록 Cloudflare 대시보드 또는 GitHub Actions Secrets 연동
SSL 보안 인증서(HTTPS) 기본 `http://` (비보안) 도메인 연결 즉시 Let's Encrypt 무료 HTTPS 자동 발급·갱신 Cloudflare Universal Edge SSL 자동 적용 및 DDoS 방어

배포 시 가장 많이 실패하는 '환경변수(Environment Variables)'와 빌드 검증 명령어

로컬에서는 잘 돌아가던 프로젝트가 Vercel에서 Build Failed가 뜨는 원인의 90%는 **① 타입스크립트 문법/타입 에러**이거나 **② `.gitignore`로 인해 GitHub에 올라가지 않은 `.env.local`의 환경변수를 Vercel 대시보드에 등록하지 않았기 때문**입니다. GitHub에 푸시하기 전에 반드시 내 컴퓨터 터미널에서 아래 명령어로 프로덕션 빌드가 통과하는지 먼저 확인하세요.

# 1. TypeScript 타입 오류가 없는지 사전 검사
npx tsc --noEmit

# 2. 실제 Vercel 서버가 실행하는 것과 동일한 프로덕션 빌드 테스트
npm run build

# 3. 빌드가 성공하면 로컬에서 프로덕션 모드로 실행하여 최종 확인
npm run start

커스텀 도메인(예: `bangjang.net`) 연결 시 DNS 레코드 설정 요약

  • 루트 도메인(`@`, 예: `bangjang.net`) 연결: 도메인 등록 업체(가비아, 호스팅케이알, Cloudflare DNS 등)의 DNS 관리 화면에서 타입 A 레코드를 추가하고, 호스트 이름에 @, 값(IP 주소)에 호스팅사가 안내하는 서버 IP(Vercel의 경우 76.76.21.21)를 입력합니다.
  • 서브도메인(`www`) 연결: 타입 CNAME 레코드를 추가하고, 호스트 이름에 www, 목적지 값에 cname.vercel-dns.com을 입력하면 `www.bangjang.net`으로 접속해도 메인 도메인으로 깔끔하게 자동 리다이렉트됩니다.

댓글 (0)

첫 번째 댓글을 작성해보세요!