Linux command
cubemastercli 命令
文本
复制后可按需替换文件名、目录或参数。
常用示例
Create a sandbox template
cubemastercli tpl create-from-image --image [registry/image:tag]
Expose ports
cubemastercli tpl create-from-image --image [image] --expose-port [49999] --probe [49999]
Configure a writable layer size
cubemastercli tpl create-from-image --image [image] --writable-layer-size [1G]
Watch the build progress
cubemastercli tpl watch --job-id [job_id]
Show help
cubemastercli tpl --help
说明
cubemastercli is the command-line interface for CubeSandbox, a high-performance, secure sandbox service built on RustVMM and KVM. It is used by operators to create, build, and monitor sandbox templates that back isolated execution environments for AI agents. Templates are produced from OCI container images and encapsulate everything needed to spin up a microVM-based sandbox, including the root filesystem, writable layer, exposed ports, and a readiness probe. Once a template is built, CubeSandbox can launch sandboxes from it in under 60 ms with hardware-level isolation. The tool is typically run against a CubeMaster control plane that orchestrates the underlying microVMs on RustVMM/KVM hosts.
参数
- tpl create-from-image
- Build a new sandbox template from a container image. Submits a build job to CubeMaster.
- tpl watch
- Follow the progress of a running template build job.
- --image _registry/image:tag_
- Container image used as the base of the template.
- --writable-layer-size _size_
- Size of the writable overlay layer (e.g. _1G_). Sandboxes launched from the template get a fresh writable layer of this size.
- --expose-port _port_
- Expose a TCP port from the sandbox. May be specified multiple times.
- --probe _port_
- Port used for the readiness probe; the template is considered ready once this port accepts connections.
- --job-id _id_
- Identifier of a build job to watch, as returned by tpl create-from-image.
- --help
- Show help for the command or subcommand.
FAQ
What is the cubemastercli command used for?
cubemastercli is the command-line interface for CubeSandbox, a high-performance, secure sandbox service built on RustVMM and KVM. It is used by operators to create, build, and monitor sandbox templates that back isolated execution environments for AI agents. Templates are produced from OCI container images and encapsulate everything needed to spin up a microVM-based sandbox, including the root filesystem, writable layer, exposed ports, and a readiness probe. Once a template is built, CubeSandbox can launch sandboxes from it in under 60 ms with hardware-level isolation. The tool is typically run against a CubeMaster control plane that orchestrates the underlying microVMs on RustVMM/KVM hosts.
How do I run a basic cubemastercli example?
Run `cubemastercli tpl create-from-image --image [registry/image:tag]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.
What does tpl create-from-image do in cubemastercli?
Build a new sandbox template from a container image. Submits a build job to CubeMaster.