pp-cloud-run-admin

Google Cloud Run — Printing Press CLI

前提条件：CLI のインストール

このスキルは cloud-run-admin-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、先にインストールしてください。

1. Printing Press インストーラーを使用してインストールします。デフォルトでは、macOS/Linux の $HOME/.local/bin、Windows の %LOCALAPPDATA%\Programs\PrintingPress\bin にバイナリが配置されます。

   npx -y @mvanhorn/printing-press-library install cloud-run-admin --cli-only
   

2. 次のコマンドで確認します：cloud-run-admin-pp-cli --version
3. 報告されたインストールディレクトリが、このスキルを実行するエージェント／ランタイムの $PATH に含まれていることを確認します。

npx によるインストールが失敗した場合（Node がない、オフラインなど）は、Go を直接インストールする方法に切り替えてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/cloud/cloud-run-admin/cmd/cloud-run-admin-pp-cli@latest

インストール後に --version が「command not found」と報告する場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できていません。確認が成功するまで、スキルのコマンドを実行しないでください。

この CLI を使用する場面

エージェントやスクリプトが、gcloud の全機能を操作することなく、Cloud Run Admin API に特化したアクセスを必要とする場合に、この CLI を使用してください。特に、読み取り中心の調査、ローカルインベントリの同期、検索、フィールドを選択した JSON の取得、サービス、ジョブ、実行、リビジョン、タスク、オペレーションを関連付けるワークフローに適しています。

独自の機能

これらの機能は、この API 用の他のツールでは利用できません。

エージェント向けの Cloud Run 操作

• services list — Admin API を通じて Cloud Run サービスを一覧表示します。エージェントに適した JSON、コンパクトな出力、フィールド選択に対応しています。

  エージェントがプロジェクトとリージョン内の Cloud Run サービスのコンパクトなインベントリを必要とする場合に使用してください。

  cloud-run-admin-pp-cli services list projects/PROJECT_ID/locations/REGION --agent --select services.name,services.uri,nextPageToken
  

ローカルの状態と分析

• sync — Cloud Run リソースをローカルの SQLite ストアに同期します。これにより、API 呼び出しを毎回繰り返すことなく、サービス、ジョブ、リビジョン、実行、タスク、オペレーションを検索できます。

  オフライン検索、SQL による調査、複数リソースにわたる分析を繰り返し行う前に使用してください。

  cloud-run-admin-pp-cli sync --json
  

• search — データソースモードに応じて、同期済みの Cloud Run インベントリをローカルで検索するか、ライブ API 呼び出しにフォールバックします。

  思い出した断片的な情報から Cloud Run リソースを特定する必要がある場合に使用してください。

  cloud-run-admin-pp-cli search "api" --type services --json --select resource_type,title
  

• analytics — 同期済みの Cloud Run データをローカルで分析し、インベントリやステータスに関する質問に答えます。

  質問が単一のリソースではなく、傾向やインベントリの健全性に関するものである場合は、同期後に使用してください。

  cloud-run-admin-pp-cli analytics --json
  

ワークフローのステータス確認

• workflow — 複数の Cloud Run Admin API 操作をまとめ、オペレーター向けのワークフローを提供します。

  タスクが複数の Cloud Run リソースタイプにまたがる場合に使用してください。

  cloud-run-admin-pp-cli workflow --help
  

HTTP トランスポート

この CLI は、ブラウザー向けエンドポイントに Chrome 互換の HTTP トランスポートを使用します。通常の API 呼び出しに、常駐するブラウザープロセスは必要ありません。

コマンドリファレンス

cloud-run-admin-jobs — Cloud Run Admin ジョブを管理します

• cloud-run-admin-pp-cli cloud-run-admin-jobs create — ジョブを作成します。
• cloud-run-admin-pp-cli cloud-run-admin-jobs list — ジョブの一覧を表示します。
• cloud-run-admin-pp-cli cloud-run-admin-jobs run — このジョブの新しい実行の作成をトリガーします。

executions — 実行を管理します

operations — オペレーションを管理します

• cloud-run-admin-pp-cli operations list — リクエストで指定されたフィルターに一致するオペレーションの一覧を表示します。サーバーがこのメソッドをサポートしていない場合は、...
• cloud-run-admin-pp-cli operations wait — 指定した長時間実行オペレーションが完了するか、指定したタイムアウトに達するまで待機し、...

services — サービスを管理します

• cloud-run-admin-pp-cli services create — 指定したプロジェクトとロケーションに新しいサービスを作成します。
• cloud-run-admin-pp-cli services get-iam-policy — 指定した Cloud Run サービスで現在有効な IAM アクセス制御ポリシーを取得します。この結果には...
• cloud-run-admin-pp-cli services list — サービスの一覧を表示します。
• cloud-run-admin-pp-cli services patch — サービスを更新します。
• cloud-run-admin-pp-cli services set-iam-policy — 指定したサービスの IAM アクセス制御ポリシーを設定します。既存のポリシーは上書きされます。
• cloud-run-admin-pp-cli services test-iam-permissions — 呼び出し元が指定したプロジェクトに対して持つ権限を返します。この操作に必要な権限はありません...

適切なコマンドを見つける

実行したい操作は分かっていても、どのコマンドを使えばよいか分からない場合は、CLI に直接問い合わせてください。

cloud-run-admin-pp-cli which "<capability in your own words>"

which は自然言語による機能の問い合わせを、この CLI の厳選された機能インデックスから最も一致するコマンドに解決します。終了コード 0 は少なくとも 1 つ一致したことを示します。終了コード 2 は確実に一致するものがないことを示します。その場合は --help にフォールバックするか、より範囲を絞った問い合わせを使用してください。

レシピ

適切な Cloud Run コマンドを見つける

cloud-run-admin-pp-cli which "show service revisions" --json

特定の Cloud Run Admin コマンドを実行する前に、インテント検索を使用してください。

エージェント向けのコンパクトな出力でサービスを一覧表示する

cloud-run-admin-pp-cli services list projects/PROJECT_ID/locations/REGION --agent --select services.name,services.uri,nextPageToken

エージェントのデフォルト設定とフィールド選択を組み合わせることで、エージェントが大きなサービスペイロードを解析せずに済みます。

同期済みのインベントリを検索する

cloud-run-admin-pp-cli search "api" --type services --json --select resource_type,title

同期後に、ローカルの Cloud Run インベントリを検索します。

認証の設定

Cloud Run Admin では、cloud-platform スコープを持つ Google OAuth ベアラートークンを使用します。ローカルで使用する場合は、gcloud auth print-access-token を実行し、その値を CLOUD_RUN_ADMIN_OAUTH2C としてエクスポートしてください。トークンをコミットしたり、ドキュメントに貼り付けたりしないでください。

cloud-run-admin-pp-cli doctor を実行して設定を確認してください。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — 標準出力に JSON を出力し、エラーは標準エラー出力に出力します

• フィルター可能 — --select でフィールドの一部を選択できます。ドット区切りのパスはネストされた構造をたどり、配列では各要素をたどります。詳細な API でコンテキストを小さく保つために重要です：

  cloud-run-admin-pp-cli cloud-run-admin-jobs list mock-value --agent --select id,name,status
  

• プレビュー可能 — --dry-run でリクエストを送信せずに表示します

• オフライン対応 — 同期／検索コマンドでは、利用可能な場合にローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトを表示せず、すべての入力はフラグで指定します

• 明示的な再試行 — 既存の作成対象を成功として扱う場合に限り --idempotent を使用し、存在しない削除対象を成功として扱う場合に限り --ignore-missing を使用してください

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力をプロベナンスエンベロープでラップします。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。人間が読みやすい N results (live) の概要は、標準出力がターミナルの場合にのみ標準エラー出力に表示されます。パイプ／エージェントで利用する場合、標準出力には純粋な JSON のみが出力されます。

エージェントからのフィードバック

この CLI について気になる点に気づいたら（あなた自身でも、エージェントでも）、記録してください。

cloud-run-admin-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
cloud-run-admin-pp-cli feedback --stdin < notes.txt
cloud-run-admin-pp-cli feedback list --json --limit 10

記録は ~/.cloud-run-admin-pp-cli/feedback.jsonl にローカル保存されます。CLOUD_RUN_ADMIN_FEEDBACK_ENDPOINT が設定されていて、かつ --send が渡された場合、または CLOUD_RUN_ADMIN_FEEDBACK_AUTO_SEND=true の場合を除き、POST されることはありません。デフォルトではローカルにのみ保存されます。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で。それが積み重なっていきます。

出力の送信先

すべてのコマンドで --deliver <sink> を指定できます。標準出力に加えて（または標準出力の代わりに）、出力を指定した送信先に渡せるため、エージェントはコマンド結果を手動でパイプ処理せずに送信できます。サポートされている送信先は 3 種類です。

送信先	効果
stdout	デフォルト。標準出力にのみ書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイルを作成してからリネームします）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームが指定された場合は、サポート対象のスキームを示す構造化エラーを返して拒否されます。Webhook への送信に失敗すると、ゼロ以外の終了コードを返し、URL と HTTP ステータスを標準エラー出力に記録します。

名前付きプロファイル

プロファイルは保存済みのフラグ値のセットで、複数回の実行で再利用できます。スケジュールされたエージェントが毎回同じ設定で同じコマンドを呼び出す場合に使用します。これは HeyGen の「Beacon」パターンです。

cloud-run-admin-pp-cli profile save briefing --json
cloud-run-admin-pp-cli --profile briefing cloud-run-admin-jobs list mock-value
cloud-run-admin-pp-cli profile list --json
cloud-run-admin-pp-cli profile show briefing
cloud-run-admin-pp-cli profile delete briefing --yes

明示的に指定したフラグは常にプロファイル値より優先され、プロファイル値はデフォルト値より優先されます。agent-context は、実行時にエージェントが利用可能なプロファイルを確認できるよう、すべてのプロファイルを available_profiles の下に一覧表示します。

終了コード

コード	意味
0	成功
2	使用方法のエラー（引数が不正）
3	リソースが見つかりません
4	認証が必要です
5	API エラー（上流の問題）
7	レート制限中（待ってから再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → cloud-run-admin-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合 → MCP のインストール。それ以外の場合 → 上記の前提条件を確認してください
3. それ以外 → 直接使用（--agent を付けて CLI コマンドを実行します）

MCP サーバーのインストール

1. MCP サーバーをインストールします：

   go install github.com/mvanhorn/printing-press-library/library/cloud/cloud-run-admin/cmd/cloud-run-admin-pp-mcp@latest
   

2. Claude Code に登録します：

   claude mcp add cloud-run-admin-pp-mcp -- cloud-run-admin-pp-mcp
   

3. 確認します：claude mcp list

直接使用

1. インストール済みか確認します：which cloud-run-admin-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある前提条件を参照してください）。
2. ユーザーの問い合わせに最適なコマンドを、上記の「独自の機能」と「コマンドリファレンス」から選びます。
3. --agent フラグを付けて実行します：

   cloud-run-admin-pp-cli <command> [subcommand] [args] --agent
   

4. 曖昧な場合は、サブコマンドのヘルプを確認します：cloud-run-admin-pp-cli <command> --help。