计算实例

使用 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"

工作区计算实例常用生命周期子命令与标志说明如下:

场景

子命令

关键参数与行为说明

创建或更新计算实例

create、update

create 传入 --name、--spec-id、--cpu、--memory-gi-b 及可选副本数、镜像和 --auto-suspend-minutes;update 通过 --id 仅提交显式指定的字段(具体标志以对应 --help 为准)。

查看 Worker 副本与依赖配额

runtime、workers、py-deps-limits

runtime 与 workers 均接收 --compute-resource-id,用于核实实际运行的 Worker 副本状态。

暂停、恢复与错误重试

suspend、resume、retry

均接收 --id。resume 要求实例处于 SUSPENDED 状态,retry 要求处于 ERROR 状态;调用成功后实例状态重置为 IDLE,实际 Worker 启动进度需继续通过 runtime 确认。

删除前预检查与删除实例

preflight-delete、delete

删除前先运行 preflight-delete --id "$COMPUTE_RESOURCE_ID" 检查活动任务与工作流绑定,确认无阻塞后再运行 delete --id "$COMPUTE_RESOURCE_ID"。

# 删除前检查活动任务与工作流绑定
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"

管理员子命令

关键参数与说明

admin-list

默认返回前 50 条非 DELETED 实例。与部署匹配的客户端支持重复传入 --query-param 按目标工作区、状态或分页筛选;早期 0.1.0 离线包仅开放 --workspace-id,需筛选或翻页时可升级客户端或调用管理 HTTP 接口 计算资源。

admin-runtime

传入 --workspace-id "$AUTH_WORKSPACE_ID" 与 --compute-resource-id "$COMPUTE_RESOURCE_ID" 读取 Worker 副本状态。

admin-update

传入 --id 及至少一个更新标志,仅提交显式提供的字段。

admin-suspend、admin-resume、admin-retry

传入 --id;同样要求 resume 前为 SUSPENDED、retry 前为 ERROR,返回 IDLE 后需继续通过 admin-runtime 核查副本状态。

admin-preflight-delete、admin-delete

先运行 admin-preflight-delete --id 核实无活动工作流或任务绑定,再提交 admin-delete --id。

警告

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 输出。

最后更新于