SuperAPI AI 工具集

runpod-lifecycle-crud

部署与运维

查看项目

更新于 11-06 11:16

技能介绍

用途

该技能用于管理 Runpod 平台上可复用的基础资源,覆盖模板、网络卷、全局卷、容器仓库凭证、账户密钥、注册的 SSH 公钥以及多节点集群。目标是让资源被正确创建、通过回读确认,并保持可用状态;仅在用户明确要求清理或演示“创建后删除”时,才执行销毁。

主要能力

  • 模板:支持列出、获取、创建、更新、删除。被 Pod 或端点引用的模板会拒绝删除,需如实反馈。
  • 网络卷:支持增删改查,创建时需指定容量(10–4096 GB)和数据中心,且该数据中心须支持网络存储。卷容量只能增加,不能缩小。创建前需说明存储费用(按 GB-月计费,直到删除)。
  • 全局卷:支持列出、获取、创建、重命名、删除。创建仅需名称,计费包括存储数据和请求费用。删除时若仍有 Pod(包括停止的 Pod)或端点挂载,会返回 409 拒绝。
  • 容器仓库凭证:支持列出、获取、创建、删除。凭证为只写,回读不会返回用户名/密码,禁止在对话或日志中回显。
  • 账户密钥:支持增删改查。名称唯一且不可变,冲突创建返回 409。值只写,使用方式为在模板、Pod 或端点设置环境变量 {{ RUNPOD_SECRET_<name> }},Runpod 在启动时替换为存储值。轮换使用 update-secret,新值在下次启动时生效。
  • SSH 公钥:支持读取和全量替换(PUT)。替换前必须先读取现有密钥,将现有密钥与新密钥一起发送;仅发送新密钥会静默删除其他密钥。密钥仅对之后使用 startSsh 创建的 Pod 生效。
  • 多节点集群:支持列出、获取、创建、重命名、删除,以及查看成员 Pod 和计费。集群类型、GPU 类型和每 Pod GPU 数在创建时固定,update-cluster 仅能重命名。Pod 数量需通过控制台的 Scale cluster 调整。创建前需说明总小时价格(podCount × gpuCountPerPod × 每 GPU 价格),并等待用户明确同意。
  • 辅助读取:审计日志、组织与成员信息、数据中心 GPU 可用性、GPU 类型可用性、CUDA 版本与容量、集群计费。

使用方式

该技能通过会话中绑定的工具执行操作。每次创建或更新后,必须通过独立的读取操作验证字段是否与设置一致;每次删除后需通过回读确认资源已不存在。操作前应先列出已有资源,避免命名冲突或覆盖用户已有资源。不得操作本次会话未创建且用户未明确指名的资源。涉及计费资源时,创建前必须说明成本;集群创建还需用户明确“开始”指令。

适用场景

  • 为 Pod 或 Serverless 端点准备可复用的模板、网络卷或全局卷。
  • 管理私有镜像拉取凭证,并诊断拉取失败原因(认证失败 vs Docker Hub 匿名限流)。
  • 管理账户密钥并注入到工作负载环境变量。
  • 维护账户 SSH 公钥集合。
  • 创建和管理多节点 GPU 集群,并查询集群计费。
  • 查询审计日志和组织成员信息。
  • 为大型模型文件选择与 GPU 同数据中心的网络卷,并说明挂载路径和冷启动影响。

限制

  • 工具必须已在会话中绑定;缺失时应说明并使用最近似的读取操作,不得编造结果。
  • 凭证和密钥值只写,任何读取都不会返回,且禁止回显。
  • 网络卷容量只能增加;全局卷删除在挂载存在时会被拒绝;模板被引用时拒绝删除;仓库凭证删除可能被 Pod 使用阻止。
  • 集群创建需用户明确同意,且集群形状创建后不可通过工具修改(仅重命名),Pod 数量调整需转至控制台。
  • 审计日志和组织读取可能因账户计划或权限返回 403/404,应如实说明。
  • 错误处理中,删除成功返回 204 无响应体,需回读确认;使用中的资源删除被拒是正确的 API 响应,不应强制解除依赖。