计算实例¶
使用 moi-cli compute 查看可用规格、Worker 镜像、计算实例配置及运行时副本状态,执行创建、更新、暂停、恢复、重试与删除操作,或在具备部署级管理员权限时执行跨工作区运维操作。执行前请先完成 配置与身份认证;工作区已写入本地配置时可省略命令中的 --workspace-id。
管理工作区计算实例生命周期¶
先列出当前工作区可用的计算规格、Worker 镜像与已有实例,再读取目标实例详情及按 Worker 类型拆分的运行时副本状态:
# 查看规格、Worker 镜像与工作区计算实例列表
moi-cli -auth pat -o compute specs --workspace-id "$WORKSPACE_ID"
moi-cli -auth pat -o compute worker-images --workspace-id "$WORKSPACE_ID"
moi-cli -auth pat -o compute list --workspace-id "$WORKSPACE_ID"
# 读取实例配置详情(使用 --id)与 Worker 运行时副本状态(使用 --compute-resource-id)
moi-cli -auth pat -o compute get --workspace-id "$WORKSPACE_ID" --id "$COMPUTE_RESOURCE_ID"
moi-cli -auth pat -o compute runtime \
--workspace-id "$WORKSPACE_ID" \
--compute-resource-id "$COMPUTE_RESOURCE_ID"
工作区计算实例常用生命周期子命令与标志说明如下:
场景 |
子命令 |
关键参数与行为说明 |
|---|---|---|
创建或更新计算实例 |
|
|
查看 Worker 副本与依赖配额 |
|
|
暂停、恢复与错误重试 |
|
均接收 |
删除前预检查与删除实例 |
|
删除前先运行 |
# 删除前检查活动任务与工作流绑定
moi-cli -auth pat -o compute preflight-delete \
--workspace-id "$WORKSPACE_ID" \
--id "$COMPUTE_RESOURCE_ID"
警告
在早期 0.1.0 离线客户端中,若目标计算实例响应包含非空的 py_requirements_txt 或 py_requirements_sha Python 依赖字段,客户端严格解码会报错退出,此时服务端可能已完成 suspend、resume 或 retry 状态变更。遇到该解码报错时,请先通过产品 HTTP API 或向部署管理员获取与目标部署匹配的安装包回查实例与 Worker 实际状态,确认后再决定后续操作,避免直接重复发送命令。
管理计算规格¶
具备部署级计算规格管理权限的身份可通过以下子命令维护规格目录:
# 检查当前身份是否具备计算规格管理权限
moi-cli -auth pat -o compute spec-management-permission --workspace-id "$WORKSPACE_ID"
# 启用或停用指定计算规格
moi-cli -auth pat -o compute set-spec-enabled \
--workspace-id "$WORKSPACE_ID" \
--spec-id "$SPEC_ID" \
--enabled=true
新建或更新规格分别使用 compute create-spec 与 compute update-spec(支持通过 --node-placement-file 传入节点调度配置 JSON,运行对应 --help 查看完整标志)。
管理员跨工作区操作¶
admin-* 系列子命令仅面向部署配置的计算规格管理员开放(普通工作区 Owner 或 Genesis 管理权限不能替代该资格)。命令中的 --workspace-id 指定当前管理员可访问的鉴权工作区,具体操作目标由实例 ID 决定:
# 跨工作区列出管理目录中的计算实例(默认返回前 50 条)
moi-cli -auth pat -o compute admin-list --workspace-id "$AUTH_WORKSPACE_ID"
# 查询目标实例的管理员视图 Worker 运行状态
moi-cli -auth pat -o compute admin-runtime \
--workspace-id "$AUTH_WORKSPACE_ID" \
--compute-resource-id "$COMPUTE_RESOURCE_ID"
# 删除前预检查活动绑定,随后提交管理员删除意图
moi-cli -auth pat -o compute admin-preflight-delete \
--workspace-id "$AUTH_WORKSPACE_ID" \
--id "$COMPUTE_RESOURCE_ID"
moi-cli -auth pat -o compute admin-delete \
--workspace-id "$AUTH_WORKSPACE_ID" \
--id "$COMPUTE_RESOURCE_ID"
管理员子命令 |
关键参数与说明 |
|---|---|
|
默认返回前 50 条非 |
|
传入 |
|
传入 |
|
传入 |
|
先运行 |
警告
compute admin-delete 输出 compute admin-delete: ok 仅代表服务端已返回 HTTP 202 受理删除意图,底层计算资源仍在后台异步清理。当前 CLI 不提供独立的管理员单实例 get 子命令,且 admin-list 默认排除 DELETED 状态实例;实例从列表消失或普通查询返回 404 均不等同于底层资源已彻底释放,需确认物理清理终态时请由运维人员核查后台清理流水线。
认领旧计算实例归属权¶
compute adopt-legacy-ownership 用于通过受审计的修复操作,为历史遗留计算实例登记规范的工作区归属关系,仅限具备对应修复权限的超级管理员使用:
moi-cli -auth pat -o compute adopt-legacy-ownership \
--workspace-id "$WORKSPACE_ID" \
--id "$COMPUTE_RESOURCE_ID"
该命令会直接修改实例归属关系。执行前请先通过 get、runtime 或 admin-list 核实实例标识、当前状态及活动任务依赖并确认迁移窗口;执行完成后重新读取实例详情与 Worker 运行状态。
限制和注意事项¶
创建、扩容、恢复或重试计算实例会触发底层计算资源分配并可能产生计费成本;暂停或删除实例会影响绑定在该实例上的运行中作业。
实例顶层状态(如
IDLE、RUNNING、SUSPENDED、ERROR)与各类型 Worker 副本的实际就绪状态分开维护,排障时请同时检查get与runtime输出。