Vercel Deploy

Vercel 배포 점검 요소

프로젝트를 가져온 뒤에도 빌드 명령, 루트 경로, 환경 값이 맞지 않으면 배포 화면은 쉽게 실패합니다.

저장소 연결

프로젝트 임포트 경로 확인

Git 저장소, framework preset, root directory가 실제 Next.js 앱 위치와 맞는지 먼저 고정합니다.

빌드 파이프

빌드 설정 명령 검증

install, build, output 경로가 패키지 매니저와 앱 구조에 맞는지 preview 배포에서 확인합니다.

런타임 값

환경 변수 환경별 등록

production과 preview 값을 분리해 DB, 인증, 외부 API가 잘못된 환경을 바라보지 않게 합니다.

실패 추적

배포 로그 원인 분류

타입 오류, 환경 변수 누락, 설치 실패, 빌드 메모리 문제를 명령 출력에서 나눠 봅니다.

자동 배포

preview/production 배포

브랜치별 preview URL과 main 브랜치 production 배포 규칙을 이해하면 검수 흐름이 단순해집니다.

배포 항목

빌드 설정install, build, output 경로가 Next.js 프로젝트와 맞는지 봅니다.
환경 변수production과 preview에 필요한 값을 각각 등록합니다.
배포 로그빌드 실패 원인을 명령 출력과 환경 차이에서 추적합니다.