运行实例
功能概述
| 项目 | 内容 |
|---|---|
| 适用角色 | 模型提供方 |
| 导航路径 | AI基础设施 > On-Prem > 开发资源 > 运行实例 |
| 页面路由 | /powerone/inference/online-inference |
| 管理对象 | 运行实例、单节点任务、集群任务、镜像、规格、启动命令和运行状态 |
新手理解
运行实例像一台按需启动的任务机器：你准备好镜像、代码、数据和启动命令，平台按所选规格启动实例。它比在线 IDE 更偏任务执行，比模型实例更灵活。
术语表
| 术语 | 说明 |
|---|---|
| 镜像 | 实例运行时使用的容器环境。 |
| 启动命令 | 容器启动后执行的命令或脚本。 |
| 批处理 | 一次性或周期性处理数据、转换文件或生成结果的任务，通常在处理完成后退出。 |
推荐操作顺序
先确认运行实例、单节点任务、集群任务、镜像、规格、启动命令和运行状态的前置依赖，再按主要操作顺序处理，最后执行结果校验并进入后续页面。
小白先看
先确认当前任务是否涉及运行实例、单节点任务、集群任务、镜像、规格、启动命令和运行状态，再按照推荐顺序操作。页面字段或状态与预期不符时，先回到前置对象页核对依赖，不要跳过结果校验直接进入下游流程。
前提条件
- 当前账号具备创建运行实例的权限。
- 已有可用镜像和规格。
- 训练脚本、模型文件或输入数据已准备。
- 输出目录已规划到对象存储、文件存储或共享目录。
- 启动命令不包含真实密钥、密码、token 或 AK/SK。
页面说明
页面用于查看和处理运行实例、单节点任务、集群任务、镜像、规格、启动命令和运行状态。
列表页支持按地域和状态筛选，提供刷新和创建入口。创建页先选择单节点或集群部署类型。
主要操作
查看资源实例
- 进入对应开发资源页面，按名称、项目、状态、规格或更新时间筛选。
- 打开详情，核对镜像、规格、存储、网络、运行状态和创建时间。
- 无结果时重置筛选并检查项目与地域；内部地址和凭据外发前必须脱敏。
- 状态异常时先查看事件和配额，不重复创建实例。
连接或管理实例状态
- 打开目标实例详情，确认连接入口、运行状态和关联存储。
- 连接前确认访问权限和网络范围；只使用平台提供的安全入口。
- 启动、停止、重启或删除前确认任务与数据已保存；执行这些动作前，应确认资源、数据和影响，并取得授权。
- 获批操作后检查状态和事件；异常时停止重试并按日志升级。
创建运行实例
操作步骤
- 进入
AI基础设施 > On-Prem > 开发资源 > 运行实例。 - 点击 "创建实例"。
- 在部署类型页面选择
单节点或集群。
- 点击 "填写参数"，进入运行实例创建配置页面。
- 按页面字段查看或填写实例名称、地域、镜像、资源规格、启动命令、参数、环境变量和存储挂载等配置。
- 核对部署类型、镜像、规格、启动命令、参数传入方式和存储路径。
启动命令填写建议
Python 训练脚本
用于启动训练入口脚本。文档中只说明需要核对入口脚本、数据来源、输出位置和参数传入方式，不记录真实路径或测试参数。
Shell 脚本
用于执行批处理、数据准备或多步骤任务。创建前确认脚本存在于镜像或挂载目录中，并确认输出写入持久化路径。
自定义服务
用于启动长运行服务类进程。创建前确认服务入口、监听方式、健康状态和资源释放方式。
参数传入方式
| 方式 | 适用场景 | 说明 |
|---|---|---|
| 命令行参数 | 脚本支持命令行参数。 | 通过页面参数字段传入，文档不记录真实参数。 |
| 环境变量 | 框架读取环境变量控制行为。 | 仅说明字段用途，不记录真实 Token、密码或 Endpoint。 |
| 配置文件 | 参数较多或需要复用配置。 | 确认配置文件来自已挂载目录或镜像内置路径。 |
| 挂载路径 | 输入数据、模型文件或输出结果。 | 确认输入和输出目录使用持久化存储。 |
参数速查表
| 字段名称 | 是否必填 | 字段类型 | 说明 |
|---|---|---|---|
| 实例名称 | 必填 | 文本 | 运行实例展示名称。 |
| 部署类型 | 必填 | 单选 | 选择单节点或集群形态。 |
| 地域 | 必填 | 下拉选择 | 选择创建运行实例的目标地域。 |
| 镜像 | 必填 | 下拉选择 | 选择运行实例使用的镜像。 |
| 资源规格 | 必填 | 下拉选择 | 选择运行实例使用的算力规格。 |
| 启动命令 | 必填 | 文本 | 配置容器启动后执行的命令或脚本。 |
| 参数 | 否 | 文本 | 配置传给脚本或服务的参数。 |
| 环境变量 | 否 | 键值配置 | 配置容器进程读取的环境变量。 |
| 存储挂载 | 否 | 路径 | 配置输入数据、代码、模型文件或输出目录的挂载路径。 |
| 输出路径 | 否 | 文本 | 配置训练、批处理或服务输出的持久化位置。 |
踩坑提示
训练任务启动失败时先看镜像、启动命令、数据路径和资源规格，不要只重复提交任务。
GPU/NPU 规格充足不代表依赖库匹配，框架版本、驱动和运行时也要一起核对。
训练日志、数据集路径和模型输出目录可能包含业务信息，截图和工单必须脱敏。
提交、确定、确认属于最终动作。创建运行实例会占用配额、调度资源和存储资源。
启动命令、环境变量和挂载路径配置错误可能导致实例启动失败或输出丢失。
不写真实租户、地域、镜像地址、资源规格 ID、数据路径、输出路径、Token、密码、Endpoint、启动参数、日志或测试数据。
结果校验
| 检查项 | 成功表现 | 异常时处理 |
|---|---|---|
| 页面入口 | 可进入运行实例并看到目标操作入口 | 检查运营管理员权限和对应菜单是否已开放 |
| 对象记录 | 运行实例、单节点任务、集群任务、镜像、规格、启动命令和运行状态在列表或详情中可见 | 重置筛选并核对名称、所属范围和创建结果 |
| 状态结果 | 新增或变更后的状态符合页面提示 | 查看操作提示、依赖对象状态和最近更新时间 |
| 下游使用 | 后续页面能够选择或关联目标对象 | 回到前置配置核对启用状态、归属关系和可见范围 |
常见问题
运行实例中找不到目标对象
问题现象：
页面可进入，但没有看到预期的运行实例、单节点任务、集群任务、镜像、规格、启动命令和运行状态。
可能原因：
- 筛选条件仍生效。
- 对象属于其他范围。
- 前置配置未完成。
处理方式：
- 重置筛选
- 核对所属地域或租户
- 返回前置页面确认对象状态。
运行实例的操作入口不可用
问题现象：
新增、注册或维护入口不可见或不可点击。
可能原因：
- 当前角色权限不足。
- 页面处于只读状态。
- 依赖对象不满足条件。
处理方式：
- 检查运营管理员权限
- 核对页面提示
- 先完成依赖对象配置。
运行实例的必填项没有可选值
问题现象：
表单能打开，但下拉框为空。
可能原因：
- 候选对象未启用。
- 所属范围不一致。
- 当前账号不可见。
处理方式：
- 到候选对象页面核对状态
- 确认归属关系
- 检查可见范围后刷新表单。
运行实例操作后状态异常
问题现象：
提交后记录存在，但状态不是预期值。
可能原因：
- 连通性或校验失败。
- 关联对象异常。
- 后台处理尚未完成。
处理方式：
- 查看页面提示和更新时间
- 检查关联对象
- 按状态阶段排查处理任务。
下游页面无法使用运行实例
问题现象：
当前页状态正常，但下游页面无法选择或关联运行实例、单节点任务、集群任务、镜像、规格、启动命令和运行状态。
可能原因：
- 可见范围不匹配。
- 对象未启用。
- 下游缓存未刷新。
处理方式：
- 核对启用状态和归属
- 检查角色可见范围
- 刷新下游页面并重新选择。
注意事项
不要把密钥直接写入启动命令、环境变量或截图中。
输出数据建议写入持久化存储，避免实例释放后丢失。
不写真实租户、地域、镜像地址、资源规格 ID、数据路径、输出路径、Token、密码、Endpoint、启动参数、日志或测试数据。
后续操作
- 进入实例详情查看日志和输出。
- 根据用量页面评估资源消耗。
- 完成任务后停止或释放实例。
- 将稳定命令沉淀为团队脚本或推理模板参数。