sbx template load
sbx template load
tar 파일에서 이미지를 샌드박스 런타임의 이미지 저장소로 로드하는 명령이에요. 로드된 이미지는 새 샌드박스의 템플릿으로 쓸 수 있어요. 클라우드에서는 tar를 클라우드 템플릿 레지스트리에 새 템플릿으로 업로드해요.
출처: 문서
본문
tar 파일에서 이미지를 샌드박스 런타임의 이미지 저장소로 로드해요. 로드된 이미지는 새 샌드박스의 템플릿으로 쓸 수 있어요.
tar 파일은 보통 sbx template save SANDBOX TAG --output FILE로 만들어져요.
--cloud와 함께: tar가 새 템플릿으로 클라우드 템플릿 레지스트리에 업로드돼요. 두 인자(FILE, NAME)를 받아요. NAME은 계정당 고유해야 해요.
--cpus와 --memory-mib는 필수이며, 함께 과금 가능한 샌드박스 형태 중 하나를 지정해야 해요:
micro (1 vCPU / 2048 MiB)
small (2 vCPU / 4096 MiB)
medium (4 vCPU / 8192 MiB)
large (8 vCPU / 16384 MiB)
xl (16 vCPU / 32768 MiB)
--capture-mode는 템플릿에 대해 무엇을 캡처할지 제어해요. "disk"(기본)는 로드가 더 빠르고 파일시스템에서 콜드 부팅돼요. "all"은 메모리 + 디스크 + microVM 체크포인트를 캡처해 이후 실행이 1초 미만으로 재개되지만 로드가 느려요.
클라우드 로드는 전체 tar를 레지스트리에 업로드해요. 수 GB 업로드는 몇 분이 걸릴 수 있어요. 스냅샷/로드 모델은 https://docs.docker.com/ai/sandboxes/ 를 보세요.
Options
| Option | Default | Description |
| --capture-mode | disk | 이 템플릿에 대해 캡처할 것. "disk"(기본)는 파일시스템만 캡처 — 표준 OCI 이미지에서 콜드 부팅, 더 빠른 로드. "all"은 메모리 + 디스크 + microVM 체크포인트 캡처 — 재개 시 1초 미만 TTI, 느린 로드. --cloud에서만 유효 |
| --cpus | 0 | vCPU. --memory-mib와 함께 과금 가능한 형태를 지정해야 함(--cloud에서 필수) |
| --description | | 선택적 템플릿 설명(--cloud 전용) |
| --memory-mib | 0 | MiB 단위 메모리. --cpus/--memory-mib는 과금 가능한 형태를 지정해야 함: micro (1 vCPU / 2048 MiB), small (2 vCPU / 4096 MiB), medium (4 vCPU / 8192 MiB), large (8 vCPU / 16384 MiB), xl (16 vCPU / 32768 MiB) (--cloud에서 필수) |
Global options
| Option | Default | Description |
| --cloud | | 로컬 sandboxd 대신 Docker Cloud Sandboxes API로 디스패치해요 |
| -D, --debug | | 디버그 로깅을 활성화해요 |
Examples
# tar 파일에서 이미지 로드
sbx template load /tmp/myimage.tar # Linux/macOS
sbx template load C:\Users\me\myimage.tar # Windows
# 로드된 이미지를 템플릿으로 사용
sbx run --pull never -t myimage:v1.0 claude
# 클라우드: tar를 클라우드 관리 템플릿으로 업로드 (디스크 캡처, 더 빠른 로드)
sbx --cloud template load /tmp/myimage.tar my-template --cpus 2 --memory-mib 4096
# 클라우드: 1초 미만 재개를 위해 메모리 + 디스크 + microVM 체크포인트 캡처
sbx --cloud template load /tmp/myimage.tar my-template --cpus 2 --memory-mib 4096 --capture-mode all
# 클라우드: 설명 포함
sbx --cloud template load /tmp/myimage.tar my-template --cpus 2 --memory-mib 4096 --description "Nightly baseline"