왜 배포 단위 빌드 머신 선택이 필요할까?

Vercel을 쓰다 보면 이런 상황이 자주 생깁니다. 평소에는 기본 빌드 머신으로 충분한데, 특정 릴리즈에서만 무거운 빌드(대규모 의존성 설치, 복잡한 번들링 등)를 돌려야 할 때가 있죠. 예전에는 프로젝트 설정 자체를 Turbo로 바꿔야 했기 때문에, 한 번 바꾸면 이후 모든 배포에 영향을 줬습니다.

이번 업데이트의 핵심은 **"프로젝트 설정은 그대로 두고, 이번 배포만 Turbo로"**라는 선택지를 준다는 점입니다. 임시로 리소스를 늘리고 싶을 때 매우 유용한 접근이에요. 😊

근거자료: Vercel Changelog - Turbo build machines can now be enabled per deployment

Vercel cloud infrastructure with turbo build machines for faster deployments IT Technology Image

적용 방법 3가지

1. Git 커밋 메시지에 환경 변수 포함

가장 간단한 방법입니다. push 전에 커밋 메시지에 아래 라인을 넣어주세요.

# 커밋 메시지에 아래 라인을 포함하면 해당 배포만 Turbo 빌드 머신으로 실행됩니다
git commit -m "feat: 대규모 번들 최적화\n\n#VERCEL_BUILD_MACHINE=TURBO"

2. Vercel CLI 사용 (59.20.0 이상)

# --turbo 플래그로 이번 배포만 Turbo 머신 사용
vc deploy --turbo

3. REST API로 배포 생성 시 지정

{
  "name": "my-project",
  "buildMachine": "turbo"
}

REST API로 배포를 생성할 때 buildMachine 필드를 turbo로 지정하면 됩니다. CI/CD 파이프라인에서 조건부로 Turbo를 켜고 싶을 때 특히 유용합니다.

Developer configuring Vercel turbo build machine via CLI for per-deployment optimization Algorithm Concept Visual

주의사항 및 실무 팁

항목내용
적용 범위개별 배포 단위 (프로젝트 설정 변경 없음)
CLI 요구 버전Vercel CLI 59.20.0 이상
커밋 메시지 방식#VERCEL_BUILD_MACHINE=TURBO 라인 포함
REST APIbuildMachine: "turbo" 필드 사용
비용Turbo 머신은 기본 머신보다 과금이 높을 수 있음

실무 주의점: Turbo 머신은 기본 머신보다 단가가 높습니다. "항상 켜두는" 용도가 아니라, 특정 배포에서만 임시로 리소스를 늘리는 용도로 쓰는 게 맞아요. 예를 들어 모노레포에서 대규모 패키지를 한 번에 빌드하는 릴리즈, 또는 캐시가 비어 있는 콜드 빌드가 예상되는 상황에서만 선택적으로 켜는 것을 권장합니다.

또한 커밋 메시지에 #VERCEL_BUILD_MACHINE=TURBO를 넣는 방식은 Git 히스토리에 그대로 남는다는 점을 기억하세요. 팀 컨벤션에 따라 커밋 메시지 규칙과 충돌할 수 있으니, CLI나 API 방식을 선호하는 팀도 있습니다.

Vercel dashboard showing build machine settings for web application deployment Development Concept Image

정리 및 다음 단계

이번 업데이트는 화려하진 않지만, 실무에서 "빌드 느려서 짜증나는 순간"을 정확히 겨냥한 실용적 기능입니다. 프로젝트 설정을 건드리지 않고 배포 단위로 리소스를 조절할 수 있다는 점이 핵심이에요.

다음 단계로 살펴볼 것:

  • Vercel의 빌드 캐시 전략(Remote Cache)과 Turbo 머신의 조합
  • 모노레포에서 Turbo 빌드가 특히 효과적인 워크플로 설계
  • CI/CD 파이프라인에서 조건부로 buildMachine: "turbo"를 트리거하는 패턴

함께 보면 좋은 글

본 콘텐츠는 신뢰할 수 있는 출처를 바탕으로 AI 도구를 활용하여 초안이 작성되었으며, 편집자의 검토를 거쳐 발행되었습니다. 전문가의 조언을 대체하지 않습니다.