Vercel CLI v55: 더 빠르고 예측 가능한 프로젝트 링크 (주요 변경사항)

Vercel CLI v55는 주요 버전 업데이트로, 프로젝트 링크 방식에 근본적인 변경을 도입했다. 기존에는 vercel link 실행 시 팀과 프로젝트가 혼재된 방식으로 검색돼 예측 불가능한 결과가 나오거나 의도치 않은 프로젝트에 연결되는 문제가 있었다. v55부터는 팀을 먼저 확정한 뒤 해당 팀 내에서만 프로젝트를 검색하도록 순서를 바꿨다.

핵심 포인트

팀 결정 후 프로젝트 검색 순서로 변경되어 링크 과정이 예측 가능해졌다.
--yes 플래그가 더 이상 팀을 자동 선택하지 않는다. 명시적 팀 지정 없이 --yes를 쓰면 여전히 팀 선택 프롬프트가 뜬다.
CI/에이전트 환경에서는 VERCEL_ORG_ID + VERCEL_PROJECT_ID 환경변수 조합으로만 완전 자동화가 보장된다.
기존에 vercel link --yes 또는 전역 팀 설정에 의존했던 스크립트는 명시적 팀 지정으로 수정해야 한다.

상세 정리

기존 문제: vercel link가 팀 구분 없이 전체 프로젝트를 검색해 동명 프로젝트가 여러 팀에 있으면 어느 쪽에 연결될지 보장되지 않았다.
새 팀 결정 순서: 1) 명시적 신호(--team, --scope, VERCEL_ORG_ID) → 2) Git 원격 저장소 기반 → 3) 인터랙티브 선택기. 팀이 확정된 뒤에야 프로젝트 검색이 시작된다.
프로젝트 제안 순서: 로컬 Git 저장소에 연결된 프로젝트 → 폴더명 일치 → 검색 순으로 진행된다.
--yes 동작 변경: 기존엔 팀까지 자동 선택했지만, v55부터는 팀이 명시되지 않으면 인터랙티브 선택기가 뜬다. 완전 비인터랙티브 모드는 --team 또는 환경변수가 필수다.
CI/자동화 권장 패턴: VERCEL_ORG_ID + VERCEL_PROJECT_ID 두 환경변수를 함께 설정하면 팀과 프로젝트 모두 자동 결정되어 사람 입력 없이 파이프라인이 돌아간다.
Breaking change 범위: 스크립트에서 --yes만 쓰던 부분에 --team 플래그 또는 VERCEL_ORG_ID env var 추가가 필요하다. npm i -g vercel@latest로 v55 설치 가능.

왜 읽나Vercel CLI를 CI/CD 파이프라인이나 자동화 스크립트에서 사용하는 개발자가 v55 업그레이드 시 생기는 breaking change를 파악하고 스크립트를 수정하는 데 필요하다.

Vercel Blog 블로그

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

원문 읽기

읽음 (0)

·takedown 요청