본문으로 건너뛰기

© 2026 Molayo

Vercel헤드라인2026. 05. 27. 08:36

Sandbox 지속성(Persistence) 기능 정식 출시 (GA)

요약

Vercel Sandbox의 지속성(Persistence) 기능이 정식 출시되었습니다. 이제 세션 간 파일 시스템 상태가 자동으로 저장 및 복구되어 별도의 스냅샷 관리 없이도 워크플로를 연속적으로 유지할 수 있습니다.

핵심 포인트

  • 세션 간 파일 시스템 상태 자동 저장 및 복구 지원
  • Sandbox.create() 호출 시 지속성 기능 기본 활성화
  • 스냅샷 스토리지 사용에 따른 별도 비용 발생 주의
  • Sandbox.fork(), getOrCreate() 등 새로운 SDK 메서드 추가
  • 생명주기 훅 및 사용자 정의 태그 기능 지원

이제 세션 간에 파일 시스템 상태를 자동으로 저장하고 복구합니다. 지속성(Persistence) 기능이 기본적으로 활성화되어 있어, 관리해야 할 스냅샷(Snapshot)이나 수동으로 추적해야 할 상태가 없습니다.Vercel Sandboxes

각 샌드박스(Sandbox)는 프로젝트 내에서 고유한 참조 역할을 하는 내구성이 있는 식별자를 가집니다. 이름을 통해 샌드박스를 생성, 검색 또는 재개할 수 있습니다. Vercel은 워크플로를 방해하지 않고 세션을 자동으로 시작하고 종료합니다.customizable name

Sandbox.create()를 호출하면 지속성(Persistence)이 기본적으로 활성화됩니다.

각 자동 스냅샷(Snapshot)은 컴퓨팅(Compute) 비용과는 별도로 청구되는 스냅샷 스토리지(Snapshot storage)를 소비합니다. 일시적인 워크로드(Ephemeral workloads)의 경우, 스토리지 비용을 최소화하려면 지속성 기능을 사용하지 않도록 설정하세요:snapshot storage

CLI를 통해 지속성 기능을 사용하지 않으려면 sandbox create--non-persistent를 전달하세요. 비지속성(Non-persistent) 샌드박스는 세션이 종료될 때 파일 시스템을 폐기합니다.

재개(Resuming)는 자동으로 이루어집니다. 중단된 샌드박스에 대해 runCommand() 또는 writeFiles()와 같은 호출을 하면 가장 최근의 스냅샷으로부터 새로운 세션이 시작됩니다.

기본적으로 지속성 샌드박스를 생성하려면 최신 버전으로 업그레이드하세요.

지속성 샌드박스에 대한 자세한 내용은 documentation에서 확인하실 수 있습니다.

Read more

지속성 샌드박스 생성하기

지속성 샌드박스 재개하기

기타 개선 사항

시작하기

  • : 기존 샌드박스에서 새로운 샌드박스 생성 Sandbox.fork()

  • : 장기 실행(long-lived) 샌드박스를 위한 멱등성(Idempotent) 있는 조회 또는 생성 Sandbox.getOrCreate()

  • : 샌드박스 영구 삭제 Sandbox.delete()

  • 더 풍부한 메타데이터: 스냅샷 메타데이터와 함께 활성 CPU(active-CPU) 및 네트워크 전송(network-transfer) 총량을 반환 sandbox.stop()

  • 생명주기 훅(Lifecycle hooks): onCreate, onResume, create, get, getOrCreate를 위한 훅

  • 태그(Tags): 멀티 테넌트(multi-tenant) 추적을 위해 샌드박스에 사용자 정의 속성 할당 Tags

  • pnpm install @vercel/sandbox@latest # SDK

  • pnpm install -g sandbox@latest # CLI

AI 자동 생성 콘텐츠

본 콘텐츠는 Vercel AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0