sbx template save
sbx template save
샌드박스의 스냅샷을 템플릿으로 저장하는 명령이에요. 저장된 이미지는 새 샌드박스의 템플릿으로 쓸 수 있어요. 클라우드에서는 실행 중인 클라우드 샌드박스를 클라우드 관리 템플릿으로 스냅샷해요.
출처: 문서
본문
샌드박스의 스냅샷을 템플릿으로 저장해요. 저장된 이미지는 샌드박스 런타임의 이미지 저장소에 보관되고 새 샌드박스의 템플릿으로 쓸 수 있어요:
sbx run --pull never -t TAG AGENT [WORKSPACE]
--pull never를 쓰면 레지스트리에서 풀하지 않고 저장된 이미지를 사용해요. --output을 쓰면 이미지를 tar 파일로도 내보내서 다른 호스트에서 공유하고 sbx template load FILE로 로드할 수 있어요.
--cloud와 함께: 실행 중인 클라우드 샌드박스를 클라우드 관리 템플릿으로 스냅샷해요. kit 크기 이미지의 스냅샷은 몇 분이 걸릴 수 있고, 명령이 완료를 폴링해요. --description으로 저장된 템플릿에 자유 형식 설명을 붙일 수 있어요.
--capture-mode는 무엇을 캡처할지 제어해요. "disk"(기본)는 파일시스템에서 콜드 부팅돼요. "all"은 메모리 + 디스크 + microVM 체크포인트를 캡처해 이후 실행이 1초 미만으로 재개되지만 로드가 느려요.
클라우드 스냅샷은 보통 수 GB 템플릿을 만들고 완료에 몇 분이 걸려요. 스냅샷/로드 모델은 https://docs.docker.com/ai/sandboxes/ 를 보세요.
Options
| Option | Default | Description |
| --capture-mode | disk | 이 템플릿에 대해 캡처할 것. "disk"(기본)는 파일시스템만 캡처 — 표준 OCI 이미지에서 콜드 부팅, 더 빠른 로드. "all"은 메모리 + 디스크 + microVM 체크포인트 캡처 — 재개 시 1초 미만 TTI, 느린 로드. --cloud에서만 유효 |
| -d, --description | | 템플릿 설명(클라우드 전용) |
| -o, --output | | 이미지를 tar 파일로도 내보내요 |
Global options
| Option | Default | Description |
| --cloud | | 로컬 sandboxd 대신 Docker Cloud Sandboxes API로 디스패치해요 |
| -D, --debug | | 디버그 로깅을 활성화해요 |
Examples
# 이 호스트의 새 샌드박스용 템플릿으로 저장
sbx template save my-sandbox myimage:v1.0
# 공유 가능한 tar 파일로도 내보내기
sbx template save my-sandbox myimage:v1.0 --output /tmp/myimage.tar
# 클라우드: 실행 중인 클라우드 샌드박스를 클라우드 관리 템플릿으로 스냅샷
sbx --cloud template save sbx_abc123 my-snap
# 클라우드: 저장된 템플릿에 설명 붙이기
sbx --cloud template save sbx_abc123 my-snap --description "nightly build"
# 클라우드: 1초 미만 재개를 위해 메모리 + 디스크 + microVM 체크포인트 캡처
sbx --cloud template save sbx_abc123 my-snap --capture-mode all