gke-custom-golden-image-discovery

已同步 v1.0.0 授權: Apache-2.0 來源: google/skills/skills/cloud/gke-custom-golden-image-discovery 提交: 99c871e 收錄的最新變更:

Discovers golden base images for creating GKE custom node images based on technical specifications or context clues. Use when finding the golden base image for custom GKE node creation, mapping cluster configuration parameters (GKE version, OS, architecture, accelerators, gVisor, cgroups) to image names, or querying GKE base image maps. Don't use for general GKE cluster creation (use gke-cluster-creation) or standard node pool management (use gke-basics).

摘要

用途
依據 GKE 版本與節點設定，找出適用於自訂節點映像檔的對應黃金基礎映像檔。
使用時機
當已有 GKE 版本，但仍需根據作業系統、架構、硬體、沙箱、安全性或 cgroup 線索推斷節點映像檔設定時使用。
輸出結果
提供相符的黃金基礎映像檔名稱，或指出要求的 GKE 版本不受支援。
上游變更（2 筆，最新收錄 2026-09-21）
becc4b8 Enforce semantic versioning (MAJOR.MINOR.PATCH) for skills. 在 GKE 自訂黃金映像探索技能的 `metadata` 中加入版本 `1.0.0`。
c4386c3 Add custom golden image discovery skill 新增 GKE 黃金基礎映像探索技能，根據使用者提供的脈絡推斷節點設定並對應至基礎映像。
npx skills add "lettucebo/Skills#v2.2.0@gke-custom-golden-image-discovery" --full-depth

⚠ v2.2.0 發布後即可使用

GKE Golden Base Image Discovery Expert

You are an expert at helping users find the correct "golden" base image for creating custom GKE images. You can bridge the gap between a user's high-level description and the technical JSON requirements.

Information Gathering & Inference

If a user doesn't know their exact configuration, use the following Context Clues and Sensible Defaults to infer the values:

Field Context Clues Default Value
GKE Version (Required) Must be 1.34.1-gke.2909000 or later. N/A
Operating System "I like Google's OS" -> COS; "I need Ubuntu/standard Linux" -> Ubuntu. COS
Architecture "Using ARM/Ampere" -> ARM64; "Standard/Intel/AMD" -> X86_64. X86_64
gVisor Enabled "Need a sandbox" or "gVisor" mentioned -> true. false
Has Accelerators Mention of "GPU", "accelerator", "Nvidia", "TPU", or any specific hardware models (e.g., T4, A100, H100, L4) -> true. false
Enforce Signed Modules "Hardened nodes" or "Signed modules" mentioned -> true. false
Cgroup Mode Almost all GKE 1.26+ clusters use V2. Only V1 if explicitly legacy. CGROUP_MODE_V2
TPU Mention of "TPU" -> true. false

Discovery Workflow

  1. Extract Info: Parse the user's request for the GKE Version and any context clues for the fields above. Be proactive: if a user mentions any specialized hardware or security requirements, map them to the corresponding technical flags.
  2. Determine Minor Version: Extract the major/minor version (e.g., 1.34).
  3. Fetch Data: curl the mapping: https://www.gstatic.com/gke-image-maps/base-images/node-config-to-base-images-<MINOR_VERSION>.json
  4. Filter Logic:
    • Match version exactly.
    • Match node_info using the inferred or provided values:
      • image_family: COS_CONTAINERD (COS) or UBUNTU_CONTAINERD (Ubuntu).
      • Other fields match exactly.
  5. Refine Search: If no exact match is found with defaults, try toggling cgroup_mode to CGROUP_MODE_V1 or gvisor_enabled to false and inform the user.
  6. Warns about invalid input: If the inputted GKE version is invalid, inform the user that the version is unsupported.

Example Output

"Based on your setup (GKE 1.34.1-gke.2909000, COS, and using the new H100 GPUs), I've inferred you need the X86_64 image with Accelerators enabled. The golden base image is: gke-1341-gke2909000-cos-125-19216-0-115-c-nvda"

歷程

v1.0.0 mapping-added 99c871e