Vercel CLI로 프로젝트 설정 업데이트하기

Vercel CLI v54.21.1부터 vercel project update 명령으로 웹 대시보드 없이 터미널에서 직접 프로젝트 빌드 설정을 수정할 수 있다. 프레임워크 프리셋, 빌드 명령, 출력 디렉토리 등을 CLI 플래그로 지정하거나 자동 감지 모드로 리셋하며, JSON 출력으로 스크립트·에이전트 통합도 지원한다.

핵심 포인트

vercel project update [프로젝트명] --framework nextjs --build-command "pnpm build" 형태로 빌드 설정을 CLI에서 바로 변경한다.
--auto-detect 플래그로 특정 설정을 자동 감지 모드로 리셋할 수 있다.
--format=json으로 결과를 stdout 전용 JSON으로 출력해 스크립트·CI 파이프라인에서 파싱하기 쉽다.
자동화 에이전트가 빌드 실패를 감지한 뒤 CLI로 설정 수정 후 재배포하는 워크플로우에 활용 가능하다.

상세 정리

기능 추가 배경: 기존에는 프로젝트 빌드 설정 변경이 Vercel 웹 대시보드에서만 가능했다. CLI 도구만으로 완결되는 배포 파이프라인 구성이 어려웠다.
기본 사용법: 링크된 프로젝트 디렉토리 안에서 vercel project update 실행, 또는 vercel project update my-project처럼 프로젝트명을 명시해 원격으로 변경한다.
주요 플래그: --framework(프레임워크 프리셋), --build-command(빌드 명령), --output-directory(출력 디렉토리), --install-command 등 주요 빌드 설정 항목을 모두 지정 가능.
--auto-detect: 특정 설정값을 삭제하고 Vercel의 자동 감지로 되돌린다. 수동 지정한 설정을 초기화할 때 사용.
--format=json: 명령 결과를 구조화된 JSON으로 stdout에만 출력 — stderr·info 메시지와 분리되어 쉘 스크립트·CI 파이프라인에서 파싱하기 쉽다.
에이전트 통합: 빌드 실패를 감지한 자동화 에이전트가 대시보드 접근 없이 프레임워크 프리셋·빌드 명령·출력 디렉토리를 수정 후 재배포하는 use case를 Vercel이 공식 문서에서 명시.
요구 사항: Vercel CLI 54.21.1 이상. npm i -g vercel@latest로 업데이트.

왜 읽나Vercel 배포를 CI/CD 파이프라인이나 자동화 에이전트로 관리하는 개발자·DevOps 엔지니어에게 대시보드 없이 CLI만으로 프로젝트 설정을 완결하는 방법을 보여준다.

Vercel Blog 블로그

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

원문 읽기

읽음 (0)

·takedown 요청