← 返回命令列表

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.