Vercel 배포 경계

배포 설정은 저장소 연결, 환경값, 런타임, 복구 경로를 함께 묶어 봐야 한다

Vercel에 Next 앱을 연결하면 배포는 쉬워지지만 운영 기준이 자동으로 맞춰지지는 않는다. 프로젝트 루트, 빌드 명령, 공개 환경값, 실행 위치, 프리뷰와 운영의 차이, 되돌리기 경로를 한 흐름으로 검증해야 한다.

01 저장소 연결 앱이 있는 폴더와 패키지 매니저를 맞춘다 잘못된 루트는 의존성 설치부터 다른 결과를 만든다. root: apps/web install: pnpm install
02 빌드 산출 로컬 운영 빌드와 같은 명령을 쓴다 개발 서버 성공과 실제 빌드 성공은 다르다. build: next build output: .next
03 환경값 분리 프리뷰와 운영의 비밀값을 섞지 않는다 브라우저에 공개되는 값과 서버 전용 값을 이름부터 나눈다. server: DATABASE_URL client: NEXT_PUBLIC_ORIGIN
04 배포 검증 URL, 로그, 캐시, 되돌리기를 확인한다 프리뷰 주소와 운영 도메인에서 같은 경로가 열리는지 본다. smoke: /, /login, /api/health rollback: previous deployment
프리뷰는 기능 검증 공간이다 운영 비밀값을 쓰지 않고 PR별 URL에서 화면, API, 권한 흐름을 확인한다.
운영은 사용자 트래픽 경로다 도메인, 캐시, 로그 수집, 분석 도구, 알림 기준이 실제 사용자 기준으로 묶인다.
엣지는 빠르지만 제약이 있다 Node 전용 모듈, 파일 시스템, 일부 네이티브 의존성은 실행 위치를 다시 골라야 한다.
빌드 로그가 첫 번째 증거다 설치, 타입 확인, 빌드, 라우트 생성 중 어느 단계에서 실패했는지 남긴다.
환경값은 범위를 기록한다 서버 전용, 브라우저 공개, 프리뷰 전용, 운영 전용 값을 표로 나눈다.
복구는 데이터 호환성까지 본다 이전 배포로 돌아가도 마이그레이션과 캐시가 맞는지 별도로 확인한다.