Sandbox 命令使用说明

前置条件

设置环境变量（仅需 2 个）：

export YR_SERVER_ADDRESS="<server-address>:8888"
export YR_JWT_TOKEN="<jwt-token>"

SDK 会自动推断 in_cluster=false、enable_tls=true、server_name，无需手动设置。

命令一览

创建 Sandbox

yrcli sandbox create --namespace <命名空间> --name <名称>

yrcli sandbox create --namespace test --name mybox
# sandbox created, instance_name=test-mybox

默认配置：CPU 1000m、内存 2048MB、空闲超时 24 小时、lifecycle=detached。

列出 Sandbox

yrcli sandbox list                  # 列出所有
yrcli sandbox list --namespace test # 按命名空间过滤

查询 Sandbox 详情

yrcli sandbox query <sandbox-id>

删除 Sandbox

yrcli sandbox delete <sandbox-id>

yrcli sandbox delete test-mybox
# succeed to delete sandbox: test-mybox

远程执行命令

yrcli exec <sandbox-id> "<命令>"

yrcli exec test-mybox "ls /tmp"           # 执行单条命令
yrcli exec -i -t test-mybox "bash"        # 交互式终端

-i 分配 stdin，-t 分配 TTY，用于交互式会话。exec 通过 WebSocket 隧道连接到 sandbox 实例。

Token 管理

# 申请 token
yrcli token-require --iam-address <iam地址> --tenant-id <租户ID> --role admin

# 验证 token
yrcli token-auth --iam-address <iam地址> --token "<token>"

# 吊销 token
yrcli token-abandon --iam-address <iam地址> --token "<token>"