샌드박스 상태 자동 저장·복원 정식 출시
Vercel Sandboxes가 세션 간 파일시스템 상태를 자동으로 저장하고 복원하도록 바뀌었습니다.
교안에 영향
이전의 sandbox는 기본적으로 비영구적이라는 안내는 더 이상 맞지 않습니다.
요약
- Sandbox.create() 기본값이 영구 저장으로 바뀌어 세션 사이에 파일시스템 상태가 자동으로 보존됩니다. - 중지된 sandbox에 runCommand()나 writeFiles()를 호출하면 가장 최근 snapshot에서 새 세션으로 자동 재개됩니다. - Sandbox.fork(), Sandbox.getOrCreate(), Sandbox.delete()가 추가되고, Sandbox.stop()은 snapshot 메타데이터와 사용량 정보를 더 자세히 돌려줍니다. - onCreate와 onResume lifecycle hooks, Tags 지원이 추가되어 생성·재개 시점과 멀티테넌트 추적을 더 세밀하게 다룰 수 있습니다. - CLI의 --non-persistent로 영구 저장을 끌 수 있으며, snapshot storage는 compute와 별도로 과금됩니다.
바뀐 것
새 기능
- Sandbox.create()의 기본 동작이 영구 저장으로 바뀌어 세션 사이에 파일시스템 상태를 자동으로 저장하고 복원합니다.
- sandbox의 이름이 지속 가능한 고유 참조로 동작해 이름으로 sandbox를 만들거나 조회하거나 재개할 수 있습니다.
- 중지된 sandbox에 runCommand()나 writeFiles()를 호출하면 가장 최근 snapshot에서 자동으로 새 세션이 시작됩니다.
- Sandbox.fork()가 추가되어 기존 sandbox에서 새 sandbox를 만들 수 있습니다.
- Sandbox.getOrCreate()가 추가되어 long-lived sandbox를 멱등적으로 조회하거나 생성할 수 있습니다.
- Sandbox.delete()가 추가되어 sandbox를 영구 삭제할 수 있습니다.
- create, get, getOrCreate에 onCreate와 onResume lifecycle hooks가 추가되었습니다.
- Tags가 추가되어 sandbox에 사용자 지정 속성을 넣어 multi-tenant 추적을 할 수 있습니다.
개선
- Sandbox.stop()이 snapshot 메타데이터와 active-CPU, network-transfer 총계를 함께 반환하도록 더 자세해졌습니다.
기타
- CLI에서 --non-persistent를 sandbox create에 전달해 영구 저장을 끌 수 있습니다.
- pnpm install @vercel/sandbox@latest와 pnpm install -g sandbox@latest로 최신 버전 설치를 안내합니다.