runpod-usage

Runpod 使用说明（概念）

在采取行动前，了解背景知识，以便做出正确选择。此技能不会运行任何内容——了解该怎么做后，请使用 runpod-mcp/runpodctl（基础设施）、flash（你自己的代码）或 companion-clis（模型／图像／数据）执行。

此技能负责解释；黄金路径提供演示。 如果你真正想问的是“如何做 X”，而不是“X 是如何运作的”，经过验证的端到端示例会更快地给出答案——runpod/golden-paths/README.md。先在此处了解概念，再按照相应路径操作。

要为自定义模板编写文件，请使用 runpod-build-template；此部分提供通用概念，而不是另一套相互竞争的打包工作流。

阅读与问题对应的参考文件：

问题	阅读
首次运行的设置／身份验证——获取并设置 RUNPOD_API_KEY、SSH、companion 凭据	reference/getting-started.md
Pods 与无服务器、工作进程、冷启动、FlashBoot、队列与负载均衡	reference/concepts.md
任何工作负载的开发循环（从这里开始）——规划 → 优先使用预构建方案 → 配置资源 → 验证 → 拆除	reference/development-loop.md
在 pod 上启动／迭代工作负载——pod 子循环	reference/pod-workflows.md
部署／迭代无服务器端点——Hub、flash 或自定义方案，调用与验证	reference/endpoint-workflows.md
在 pod 上安装软件——软件包管理规范、uv、非交互模式、缓存	reference/on-pod-setup.md
构建 Runpod 可运行的 Docker 镜像（处理程序契约、Dockerfile、--platform=linux/amd64）	reference/docker.md
如何构建优质镜像——基础镜像、分层、内置与卷、pod 与无服务器（队列／负载均衡）契约	reference/building-images.md
数据存储位置——容器磁盘与网络卷、模型缓存、S3 访问	reference/storage.md
选择哪种 GPU／需要多少 VRAM／使用哪个 CUDA 版本／成本与可用性／数据中心	reference/gpu-selection.md
为什么已停止的 pod 可能无法使用 GPU 重启——pod 绑定到一台机器；还有哪些内容按机器划分	reference/pods-and-machines.md
端点发布、滚动更新、版本重叠、GitHub 构建	reference/endpoint-builds-and-releases.md
将 API 令牌和密钥存储为机密，并从环境变量中引用	reference/secrets.md
通过 HTTP 访问 pod 或端点（代理 URL、公开端口）	reference/networking.md
常见错误及避免方法	reference/gotchas.md

精确事实：概念文件

参考文件负责解释。如需精确事实，或了解操作必须满足的规则，请阅读此文件旁 concepts/ 目录中的概念文件。每个概念对应一个 YAML 文件（pod.yaml、network-volume.yaml、machine.yaml 等），其中列出字段、状态、关系和规则，且每条规则都会引用其来源的公开资料。

grep -il "volume disk" concepts/*.yaml    # find the concept by name or alias
grep -n "statement:" concepts/pod-volume-disk.yaml

• rules[].statement 是事实。see: 指向其他概念中的相关规则。
• 带有 conflict: true 的规则记录了两个公开来源之间的分歧。请同时说明两种说法。
• kind: process 文件会逐步说明流程。pod-deployment.yaml 介绍部署、停止和重启，包括即使数据中心仍有库存，重启也可能失败的原因。