DEV WIKI
인프라 · 플랫폼

Vercel

Vercel은 프로젝트 설정과 Git 변경을 기준으로 빌드·배포를 수행하는 플랫폼입니다. 배포 실패를 확인할 때는 로컬 실행 결과와 Vercel 빌드 환경, 환경 변수, 생성된 경로를 분리해야 합니다.

플랫폼 정의

Vercel은 Git 저장소의 변경과 프로젝트 설정을 바탕으로 웹 애플리케이션을 빌드하고 배포합니다. 로컬에서 동작하더라도 배포 환경의 Node.js 버전, 환경 변수, 빌드 명령과 출력 경로가 다르면 결과가 달라질 수 있습니다.

배포 문제 확인

  1. 실패한 배포의 브랜치·커밋과 Vercel 빌드 로그를 기록합니다.
  2. 프로젝트의 빌드 명령, 출력 방식과 Node.js 버전을 확인합니다.
  3. 로컬 비밀값을 복사하지 않고 Vercel 환경 변수에 필요한 이름과 환경을 확인합니다.
  4. 배포가 성공한 뒤 실제 도메인에서 정적 자산과 서버 경로를 다시 요청합니다.

관련 구성요소

공식 참고 자료

최근 검토된 문서