피드로 돌아가기
Dev.toDevOps
원문 읽기
VERCEL_EXPERIMENTAL_DEV_SKIP_LINK를 통한 Local Dev Link 의존성 제거 및 부팅 병목 해결
VERCEL_EXPERIMENTAL_DEV_SKIP_LINK: Stop Dev Link Hangs
AI 요약
Context
Vercel CLI는 Local 환경에서 Vercel-only 서비스(KV, Postgres 등)의 데이터 동기화를 위해 api.vercel.com과 HTTP 핸드셰이크를 통한 Dev Link를 생성함. 브라우저가 없는 CI 환경이나 네트워크 제한 상황에서 해당 프로세스가 Block되어 Next.js dev 서버의 부팅이 중단되는 Hang 현상이 발생함.
Technical Solution
- VERCEL_EXPERIMENTAL_DEV_SKIP_LINK 환경 변수 도입을 통한 CLI Wrapper의 Link 생성 단계 선택적 생략
- .vercel/project.json 생성 및 API 서버와의 네트워크 라운드 트립 과정을 완전히 배제하는 Opt-in 메커니즘 설계
- CLI Wrapper와 Next.js Dev Server의 실행 계층을 분리하여 프레임워크의 기본 Node 프로세스 동작만 유지
- .env.local 설정을 통한 로컬 스코프 제한으로 프로덕션 런타임 및 빌드 파이프라인에 영향이 없는 격리 구조 채택
- Monorepo 내 다수 앱 실행 시 발생하는 .vercel 디렉토리 공유 및 Link 충돌 문제를 우회하는 독립적 실행 환경 확보
실천 포인트
- CI/CD 파이프라인 및 Docker 컨테이너 내 Next.js 실행 시 해당 플래그 설정을 통해 인증 단계 제거 - 오프라인 개발 또는 제한된 네트워크 환경에서 Socket Timeout으로 인한 서버 부팅 지연 방지 - Monorepo 구조에서 동일 프로젝트를 공유하는 다수 앱 실행 시 Link 충돌 방지를 위해 보조 앱에 적용 - Vercel KV/Postgres 등 전용 서비스의 로컬 에뮬레이션이 불필요한 경우에만 활성화