sbx kit pull

sbx kit pull

sbx kit pull은 OCI 레지스트리에서 kit 아티팩트를 가져오는 명령이에요. 원격 레지스트리의 kit를 받아 로컬 파일로 저장하고 싶을 때 써요. (실험적)

출처: 문서

본문

OCI 레지스트리에서 kit 아티팩트를 가져와 그 레이어 페이로드를 파일로 저장해요. 참조는 "registry/repo:tag" 또는 "registry/repo@sha256:digest" 형식이어야 해요 (예: "ghcr.io/myorg/my-plugin:1.0"). 파일 확장자는 kit의 형식에 따라 자동으로 선택돼요.

  • schemaVersion: "1".zip (레거시 ZIP 아카이브)
  • schemaVersion: "2".tar.gz (표준 OCI tar+gzip 레이어)

레지스트리는 HTTPS를 지원해야 해요. 인증: sbx registry secrets(sbx secret set --registry)가 우선하고, Docker 자격 증명 저장소로 폴백해요.

사용법 (Usage)

sbx kit pull REFERENCE [flags]

참고: 이 명령은 실험적(experimental) 기능이에요. 실험적 기능은 테스트와 피드백을 위한 것이며, 기능이나 설계가 릴리스 사이에 예고 없이 바뀌거나 향후 릴리스에서 완전히 제거될 수 있어요.

옵션 (Options)

옵션 기본값 설명
-o, --output 출력 파일 경로예요 (기본: 참조 + 형식에서 파생)

전역 옵션 (Global options)

옵션 기본값 설명
--cloud 로컬 sandboxd 대신 Docker Cloud Sandboxes API로 디스패치해요 (점점 더 많은 동사가 지원됨 — 현재 목록은 sbx --cloud --help 실행)
-D, --debug 디버그 로깅을 활성화해요

더 알아보기 (Learn more)