Vercel 빌드 파이프라인이 대형 프로젝트에서 평균 2.8초, 최대 12초까지 빌드 시간을 단축했다. 핵심 변경은 대용량 파일 식별과 디렉터리 크기 측정 등 고비용 디스크 연산을 빌드 성공 크리티컬 패스에서 제거한 것이다.
핵심 포인트- 대용량 파일 탐색과 디렉터리 크기 측정 디스크 연산을 빌드 성공 경로의 크리티컬 패스에서 제거했다.
- 이 연산들은 빌드 실패 시 또는 VERCEL_BUILD_SYSTEM_REPORT=1 환경변수 활성화 시에만 실행된다.
- 평균 2.8초 단축, 대형 프로젝트는 최대 12초 단축.
- 파일이 많거나 의존성·아티팩트가 큰 프로젝트일수록 효과가 크다.
상세 정리- 병목 원인: 모든 빌드에서 '대용량 파일 식별'과 '디렉터리 크기 측정' 디스크 연산이 크리티컬 패스에 포함돼 있었다. 파일과 의존성이 많은 대형 프로젝트에서 이 비용이 누적됐다.
- 구조적 변경: 이 디스크 연산들을 크리티컬 패스에서 분리해 빌드 실패 시에만 실행되도록 조건부로 전환했다.
- 디버그 환경변수: VERCEL_BUILD_SYSTEM_REPORT=1을 설정하면 성공 빌드에서도 이 연산을 강제 실행해 상세 보고서를 얻을 수 있다.
- 성과 수치: 평균 2.8초 단축. 소스 파일이 많거나 방대한 의존성 디렉터리 또는 빌드 아티팩트를 가진 프로젝트는 최대 12초까지 단축.
- 적용 범위: 모든 Vercel 프로젝트에 자동 적용. 별도 설정 없이 효과를 얻는다.
- 설계 원칙: 성공 경로에서 불필요한 연산을 제거하고, 실패 분석이 필요할 때만 비용을 지불하는 지연 평가 패턴을 빌드 파이프라인에 적용했다.
왜 읽나Vercel에 배포하는 대형 프로젝트 개발자에게. 크리티컬 패스에서 불필요한 연산을 제거하는 빌드 파이프라인 최적화 전략을 실제 수치와 함께 볼 수 있다.