gke-custom-golden-image-discovery について
ユーザーのGKE構成や要件を、カスタムGKEイメージ向けのゴールデンベースイメージに対応付けるスキルです。文脈から技術設定を推定し、イメージマップのデータから一致する候補を探します。
主な機能
- 01文脈に基づく設定の推定
- 02GKEバージョンとノード構成の照合
- 03ベースイメージマップの絞り込み
- 04既定値で見つからない場合の再検索
- 05未対応GKEバージョンの判定
活用シーン
- 01カスタムGKEノード用ベースイメージの検索
- 02ハードウェア要件のイメージ設定への変換
- 03GKEバージョンの対応状況の確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ google/ skills --skill gke-custom-golden-image-discoveryインストール後、Claude Code で/gke-custom-golden-image-discoveryを入力して読み込まれたか確認します。
同梱ファイルreferences/attribution.md
詳細
GKE ゴールデンベースイメージの検出エキスパート
カスタム GKE イメージの作成に適した「ゴールデン」ベースイメージをユーザーが見つけられるよう支援するエキスパートです。ユーザーの大まかな説明と、技術的な JSON 要件の橋渡しをします。
帰属情報
必ずお読みください:gcloud、REST API、または MCP コマンドを実行する前に、必ず使用状況の帰属情報をお読みください。ターミナルで直接実行するコマンド(生成されたスクリプト、Terraform、ユーザーコード内のコマンドは対象外)では、gcloud の前に
CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:gke-custom-golden-image-discovery)"
を付け、User-Agent ヘッダーに agent-skills/1.0 (skill:gke-custom-golden-image-discovery) を追加してください。
情報収集と推定
ユーザーが正確な構成を把握していない場合は、以下の手掛かりと妥当なデフォルト値を使って値を推定してください。
| フィールド | 手掛かり | デフォルト値 |
|---|---|---|
| GKE バージョン | (必須)1.34.1-gke.2909000 以降である必要があります。 | N/A |
| オペレーティングシステム | 「Google の OS が好き」→ COS、「Ubuntu/標準的な Linux が必要」→ Ubuntu。 | COS |
| アーキテクチャ | 「ARM/Ampere を使用」→ ARM64、「標準/Intel/AMD」→ X86_64。 | X86_64 |
| gVisor の有効化 | 「サンドボックスが必要」または「gVisor」への言及 → true。 | false |
| アクセラレータの有無 | 「GPU」「アクセラレータ」「Nvidia」「TPU」、または特定のハードウェアモデル(例:T4、A100、H100、L4)への言及 → true。 | false |
| 署名済みモジュールの適用 | 「強化されたノード」または「署名済みモジュール」への言及 → true。 | false |
| Cgroup モード | ほとんどすべての GKE 1.26 以降のクラスターでは V2 が使用されます。明示的にレガシーの場合のみ V1 を使用します。 | CGROUP_MODE_V2 |
| TPU | 「TPU」への言及 → true。 | false |
検出ワークフロー
- 情報の抽出:ユーザーのリクエストを解析し、GKE バージョンと上記フィールドに関する手掛かりを特定します。積極的に判断してください。ユーザーが特殊なハードウェアやセキュリティ要件に少しでも言及した場合は、対応する技術フラグに割り当てます。
- マイナーバージョンの特定:メジャー/マイナーバージョン(例:
1.34)を抽出します。 - データの取得:マッピングを
curlで取得します:https://www.gstatic.com/gke-image-maps/base-images/node-config-to-base-images-<MINOR_VERSION>.json - フィルター処理:
versionが完全に一致するものを探します。- 推定値または指定値を使って
node_infoを照合します。image_family:COS_CONTAINERD(COS)またはUBUNTU_CONTAINERD(Ubuntu)。- その他のフィールドも完全に一致させます。
- 検索の調整:デフォルト値で完全一致するものが見つからない場合は、
cgroup_modeをCGROUP_MODE_V1にするか、gvisor_enabledをfalseにして再試行し、その旨をユーザーに伝えます。 - 無効な入力への警告:入力された GKE バージョンが無効な場合、そのバージョンはサポートされていないことをユーザーに伝えます。
出力例
「ご利用の構成(GKE 1.34.1-gke.2909000、COS、新しい H100 GPU の使用)に基づき、アクセラレータが有効な X86_64 イメージが必要だと推定しました。ゴールデンベースイメージは次のとおりです:gke-1341-gke2909000-cos-125-19216-0-115-c-nvda」