Vercel Sandbox의 관리 이미지 전환
Sandbox가 새 관리 이미지 체계로 바뀌고, 기본 실행 환경도 Ubuntu 기반으로 변경됐다.
교안에 영향
기존 문서의 Sandbox runtime 안내와 Amazon Linux 기본 환경, vercel-sandbox 사용자 전제는 더 이상 맞지 않을 수 있다.
요약
- Vercel Managed Images(VMI)가 새로 추가되어, 버전이 있는 오픈소스 기본 이미지를 그대로 쓰거나 확장할 수 있게 됐다. - Sandbox 런타임은 더 이상 권장되지 않으며, Sandbox SDK 3부터 새 sandbox의 기본 이미지가 vercel/sandbox/universal:latest로 바뀌었다. - universal 이미지는 Node.js, Python, common coding agents와 표준 유틸리티를 포함하고, 기본 운영체제가 Amazon Linux에서 Ubuntu로 바뀌었다. - 최신 태그와 주버전 태그는 보안 패치와 의존성 업데이트를 자동으로 받고, digest 고정으로는 자동 업데이트를 끌 수 있다. - vercel/sandbox/node, vercel/sandbox/python, vercel/sandbox/ubuntu, vercel/sandbox/arch 같은 카탈로그 이미지와 기존 runtime 호환, sudo 동작이 정리됐다.
바뀐 것
새 기능
- Vercel Managed Images(VMI)가 추가되어 버전이 있는 오픈소스 기본 이미지를 제공한다.
- vercel/sandbox/universal:latest는 Ubuntu 26.04, Node.js 24, Python 3.14, uv, opencode, claude-code, codex, pi와 여러 유틸리티를 포함한다.
- 이미지 digest(SHA)를 고정해 자동 업데이트가 없는 완전한 재현 환경을 만들 수 있다.
- vercel/sandbox/node:22, vercel/sandbox/node:24, vercel/sandbox/node:26 이미지가 Ubuntu 26.04 기반으로 제공된다.
- vercel/sandbox/python:3.14 이미지가 Ubuntu 26.04 기반으로 제공된다.
- vercel/sandbox/ubuntu:latest 이미지가 추가되어 기본 Ubuntu 26.04만 제공한다.
- vercel/sandbox/arch:latest 이미지가 추가되어 Arch Linux를 제공한다.
개선
- 기본 운영체제가 Amazon Linux에서 Ubuntu로 바뀌었다.
- 모든 managed image는 nightly release로 배포되며, latest와 주버전 태그는 운영체제와 의존성 업데이트를 자동으로 받는다.
- 이미지 내부 의존성은 가능한 한 특정 버전으로 고정되어 같은 이미지 버전의 일관성을 유지한다.
- 이미지는 프로젝트, 팀에 공유된 저장소, 공개 저장소의 경로를 참조할 수 있다.
- 이미지 주소 형식이 team-slug/project/repo:tag로 정리됐고, SDK는 image 속성을 타입 지정해 built-in 이미지를 자동완성한다.
- managed images는 vercel-sandbox 사용자가 아니라 기본 ubuntu 또는 arch 사용자로 실행되며 passwordless sudo를 사용한다.
기타
- 모든 이미지는 public vercel/sandbox 저장소에 소스가 공개된다.
- 기본 이미지는 vercel/sandbox/universal:latest이며, Sandbox SDK 3부터 새 sandbox에 기본 적용된다.
- 기존 runtime 속성은 제거되지 않고 deprecated 상태로 남아 기존 코드는 계속 동작한다.
- Amazon Linux runtimes는 managed image 카탈로그에 포함되지 않으며, AL2023이 필요한 팀은 runtime을 계속 사용할 수 있다.