runpod-usage

Runpod の使用（概念）

実行する前に適切な選択をするための基礎知識です。このスキルは何も実行しません。何をすべきかわかったら、runpod-mcp／runpodctl （インフラ）、flash（独自コード）、または companion-clis（モデル／画像／データ）を使って実行してください。

このスキルは解説し、ゴールデンパスは実例を示します。「X はどのように動作するか」ではなく「X はどうすれば実行できるか」という質問には、検証済みのエンドツーエンドの例がより迅速な回答になります。 runpod/golden-paths/README.md を参照してください。ここで概念を確認してから、該当する手順に従ってください。

カスタムテンプレート用のファイルを作成するには、 runpod-build-template を使用してください。この手順では共通の概念を説明しますが、別のパッケージ化ワークフローを提示するものではありません。

質問に合ったリファレンスファイルを 1 つ読んでください。

質問	参照先
初回セットアップ／認証 — RUNPOD_API_KEY の取得と設定、SSH、コンパニオンの認証情報	reference/getting-started.md
Pods と serverless の違い、ワーカー、コールドスタート、FlashBoot、キューとロードバランシング	reference/concepts.md
あらゆるワークロードの開発ループ（ここから開始） — 計画 → 既成のものを優先 → プロビジョニング → 検証 → ティアダウン	reference/development-loop.md
Pod でワークロードを立ち上げ、反復する — Pod のサブループ	reference/pod-workflows.md
serverless エンドポイントをデプロイし、反復する — Hub、flash、カスタムの比較、呼び出しと検証	reference/endpoint-workflows.md
Pod にソフトウェアをインストールする — パッケージ管理、uv、非対話型の実行、キャッシュ	reference/on-pod-setup.md
Runpod で実行できる Docker イメージをビルドする（ハンドラーの契約、Dockerfile、--platform=linux/amd64）	reference/docker.md
適切なイメージのビルド方法 — ベースイメージ、レイヤー化、イメージへの組み込みとボリューム、Pod と serverless（キュー／LB）の契約	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 など）が 1 つあり、フィールド、状態、関係、ルールが記載されています。各ルールには、参照元の公開情報が明記されています。

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 のルールは、意見が一致しない 2 つの公開情報を記録しています。両方の見解を提示してください。
• kind: process のファイルでは、手順を段階ごとに説明します。pod-deployment.yaml では、デプロイ、停止、再起動について、データセンターに在庫がある場合でも再起動に失敗することがある理由を含めて説明します。