Vercel 배포 파이프라인

저장소 연결

Vercel 프로젝트가 Git 저장소와 브랜치 규칙을 읽어 배포 이벤트를 만든다.

Git integration

PR마다 고유 Preview URL에서 UI, API, 환경 변수 차이를 확인한다.

preview

main 또는 지정 브랜치 배포가 production domain으로 연결된다.

promote

빌드 실패, 함수 오류, Edge 로그를 보고 필요하면 이전 배포로 되돌린다.

operate

Env

Preview와 Production 환경 변수를 분리해 실서비스 secret을 보호한다. NEXT_PUBLIC 값은 클라이언트에 노출된다는 점을 확인한다.

범위

Build

로컬 build 성공과 Vercel build 성공은 Node 버전과 env 차이로 달라질 수 있다. install command와 lockfile, framework preset을 확인한다.

remote build

Logs

Serverless Function과 Edge Function 로그 위치가 다르다. 요청 id와 배포 id를 함께 기록하면 추적이 쉽다.

observability

Preview URL PR에서 실제 배포 URL로 핵심 플로우를 확인한다.

Production env 운영 DB와 API key가 preview에 섞이지 않는다.

Rollback 문제 발생 시 되돌릴 배포 id를 알고 있다.

push branch -> Preview URL -> checks -> merge main -> Production deployment -> monitor logs