mcpField
G
gke-custom-golden-image-discovery

gke-custom-golden-image-discovery

github.com/google云与 DevOps21.6k3.7k 次安装今天更新
代码仓库

关于 gke-custom-golden-image-discovery

将用户的 GKE 配置和需求对应到适用于自定义 GKE 镜像的黄金基础镜像。它从上下文线索推断技术设置,并在镜像映射数据中查找匹配项。

主要功能

  1. 01根据用户上下文推断设置
  2. 02匹配 GKE 版本和节点配置
  3. 03筛选基础镜像映射数据
  4. 04默认值不匹配时调整搜索
  5. 05标示不受支持的 GKE 版本

适用场景

  1. 01为自定义 GKE 节点查找基础镜像
  2. 02将硬件需求转换为镜像设置
  3. 03检查 GKE 版本是否受支持

安装

复制下面的命令,在终端中运行。

$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)" ,并将 agent-skills/1.0 (skill:gke-custom-golden-image-discovery) 添加到 User-Agent 标头中。

信息收集与推断

如果用户不清楚确切配置,请使用以下上下文线索和合理默认值推断相关值:

字段上下文线索默认值
GKE 版本(必需)必须为 1.34.1-gke.2909000 或更高版本。N/A
操作系统“我喜欢 Google 的操作系统” -> 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

发现工作流

  1. 提取信息:解析用户的请求,获取 GKE 版本以及上述字段的任何上下文线索。主动判断:如果用户提到任何特殊硬件或安全要求,将其映射到相应的技术标志。
  2. 确定次要版本:提取主版本/次要版本(例如 1.34)。
  3. 获取数据:通过 curl 获取映射:https://www.gstatic.com/gke-image-maps/base-images/node-config-to-base-images-<MINOR_VERSION>.json
  4. 筛选逻辑:
    • 精确匹配 version。
    • 使用推断或用户提供的值匹配 node_info:
      • image_family:COS_CONTAINERD(COS)或 UBUNTU_CONTAINERD(Ubuntu)。
      • 其他字段均须精确匹配。
  5. 细化搜索:如果使用默认值找不到完全匹配项,尝试将 cgroup_mode 切换为 CGROUP_MODE_V1,或将 gvisor_enabled 设为 false,并告知用户。
  6. 对无效输入发出警告:如果输入的 GKE 版本无效,告知用户该版本不受支持。

输出示例

“根据你的配置(GKE 1.34.1-gke.2909000、COS,以及使用新的 H100 GPU),我推断你需要启用加速器的 X86_64 映像。黄金基础映像为:gke-1341-gke2909000-cos-125-19216-0-115-c-nvda”

评论

支持 Markdown