Vercel CLI 드라이런 배포로 실제 배포 전 구성 미리 확인하기

Vercel CLI v54.17.2부터 vercel deploy --dry 명령으로 실제 파일 업로드 없이 배포 구성을 미리 검사할 수 있다. 프레임워크 감지 결과, 포함/제외 파일 목록, 디렉터리 크기 분포, 콘텐츠 해시까지 사전에 확인하고 나서 배포를 결정할 수 있어 의도치 않은 배포 실패를 예방한다.

핵심 포인트

vercel deploy --dry 실행으로 코드 업로드 없이 프레임워크 감지, 파일 수, 크기, 무시 경로 요약을 확인한다.
--format=json 플래그로 JSON 매니페스트를 반환받아 자동화 파이프라인이나 AI 에이전트와 연동 가능하다.
예상치 못한 파일 포함, 큰 에셋, 의심스러운 파일 모드를 사전에 발견해 불필요한 배포 실패를 예방한다.
.vercelignore 설정을 반복적으로 검증하며 코드 업로드 없이 튜닝할 수 있다.
AI 에이전트가 배포 전 매니페스트를 자동 검증하는 단계로 활용하기 적합하다.

상세 정리

배경: 실제 배포 전까지 어떤 파일이 포함되고 프레임워크가 어떻게 감지되는지 알 수 없어 의도치 않은 파일 업로드나 배포 실패가 발생했다.
기본 사용: vercel deploy --dry를 링크된 프로젝트에서 실행하면 프레임워크 프리셋, 파일 수, 크기, 무시된 경로를 포맷된 요약으로 출력한다.
JSON 출력: --format=json 추가 시 감지된 프레임워크, 포함/무시 경로, 디렉터리 크기 분포, 최대 파일 목록, 파일 모드, 콘텐츠 해시를 JSON으로 반환한다.
.vercelignore 튜닝: dry-run과 .vercelignore 수정을 반복해 원하는 파일 목록이 될 때까지 코드 업로드 없이 검증 가능하다.
자동화 활용: 에이전트가 JSON 매니페스트를 파싱해 프레임워크 감지 이상, 예상치 못한 파일, 과도한 크기의 에셋, 의심스러운 파일 모드를 자동 검출한다.
반복 검증 흐름: dry-run 실행, 매니페스트 분석, .vercelignore 수정, dry-run 재실행을 배포 의도와 일치할 때까지 반복 — 모두 업로드 없이 진행 가능하다.
요구 사항: Vercel CLI v54.17.2 이상으로 업데이트 필요.

왜 읽나Vercel 배포 구성을 사전에 검증하거나 CI 파이프라인에 배포 전 검증 단계를 추가하려는 개발자에게 바로 적용 가능한 레퍼런스.

Vercel Blog 블로그

원문은 여기서 이어서 읽을 수 있어요

원문 읽기

읽음 (0)

·takedown 요청