1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | GKE Basics |
| 作者/维护者 | Google（google/skills 仓库） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/gke-basics |
| 许可证 | Apache-2.0（数据来源：GitHub API） |
| GitHub Stars | 18,388（数据来源：GitHub API；该数字属整个 google/skills 合集仓库，不代表本技能自身热度） |
| Forks | 1,443（同上，合集整体数据） |
| 最新版本 | 仓库不发布正式 release，持续滚动更新；本技能目录最近一次提交为 2026-07-30（数据来源：GitHub API） |
| 安装方式 | npx skills add google/skills 交互式勾选安装，或手动复制 skills/cloud/gke-basics/ 目录到 agent 的 skills 目录 |
2. 功能介绍与亮点
GKE Basics 是 GKE（Google Kubernetes Engine）集群从零开始的入门与决策技能，覆盖创建集群、选择运行模式、获取凭据、部署第一个工作负载这一整套“第一步”流程：
- Autopilot / Standard 选型规则：明确默认推荐 Autopilot，并给出仅应改用 Standard 的三种具体场景（需要自定义内核参数
sysctl、需要自定义节点污点或专属硬件节点池、DaemonSet 需要挂载宿主机原始文件系统），避免用户凭直觉瞎选。 - 关键“坑位”清单：私有集群网络参数（禁用节点公网 IP、限制控制平面访问来源）、Workload Identity 绑定方式（明确反对把 GCP 服务账号 JSON 密钥直接挂进 Pod，改用 KSA-GSA 注解绑定）、Autopilot 资源请求必须按 250m 整数倍对齐（否则会被自动圆整，容易和预期不符）、获取凭据时必须显式指定
--region/--zone。 - 5 个专题参考文件：核心概念（架构、集群模式、网络、扩缩容、安全模型）、CLI/MCP 工具使用优先级、Python/Go/Node.js/Java 客户端库、Terraform 基础设施即代码示例、23 个结构化 GKE MCP 工具的用法说明。
亮点：
- GKE 是
google/skills仓库 2026 年 4 月 Google Cloud Next 大会首发的 13 个技能之一，是 7 个“产品技能”中唯一的容器编排类目，官方持续投入。 - 正文把“避免踩坑”作为第一优先级组织内容，而非泛泛的功能罗列——每条建议都配具体命令或 YAML 片段，可直接照抄使用。
- 主动教导安全最佳实践（Workload Identity 优于原始密钥挂载），而非仅描述功能。
3. 适用场景
固定分类：DevOps 与基础设施。
适用于刚开始接触 GKE、需要创建第一个集群并在 Autopilot 与 Standard 模式之间做选型的平台工程师与后端开发者；也适用于已有 GKE 经验但想系统核对凭据获取、Workload Identity 配置等常见易错点是否做对的场景。该技能定位为其他专项 GKE 技能（网络、存储、安全加固、多租户等）的入口与前置知识，覆盖几乎所有 GKE 新用户都会经历的第一步。
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库 README 明确列出
claude plugin marketplace add google/skills安装路径，随后claude plugin install <plugin>@google-plugins即可。 - Codex：原生支持——仓库 README 明确列出
codex plugin marketplace add google/skills，随后从/plugins浏览器安装。 - OpenClaw：未验证——未见到针对该 agent 的专门说明。
- Hermes Agent：未验证——未见到针对该 agent 的专门说明。
5. 推荐理由
它把新建 GKE 集群时最容易踩的几个坑（该选哪种模式、私有集群网络参数怎么配、密钥该怎么处理、Autopilot 资源请求为什么和预期不一样）提前集中说明，省去用户自己翻官方文档摸索或靠生产事故交学费的过程；给出的命令与 YAML 片段可直接执行，并明确指路到同仓库的专项技能（网络、安全、升级等）完成后续深入配置。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 Google 为一线云厂商且是 GKE 产品本身的所有者，属官方出品；google/skills 合集仓库 18,388 星不计入单个子技能，检索 GitHub issues/PR 与公开网络均未找到针对本技能自身的独立第三方讨论 |
| 可用性 | 9 | SKILL.md 单文件即为完整安装单元，另配 5 个专题参考文件（CLI/MCP 用法、核心概念、客户端库、IaC 示例），文档完整且给出可直接执行的命令与代码片段；技能目录最近一次提交在 2026-07-30（近 3 个月内的专项重构），除用户自有 GCP 账号外无额外付费依赖 |
| 安全性 | 8 | 全部内容开源可审计（Apache-2.0）；涉及集群创建、凭据获取、IAM 绑定等具备实际写入能力的命令，但每条都说明了具体用途与范围，且正文主动引导安全最佳实践（反对原始密钥挂载、改用 Workload Identity），未见外发数据或可疑指令 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | gcloud container clusters create-auto/get-credentials 等集群创建与凭据获取命令，范围明确、均针对用户自己的 GCP 项目 |
| ② 运行时联网外发 | 无独立外发；命令均针对用户自己的 GCP 项目执行 |
| ③ API key/凭据 | 复用用户本机已有的 gcloud 认证态；正文明确反对把服务账号 JSON 密钥直接挂载进 Pod，推荐 Workload Identity 绑定方式 |
| ④ 可疑指令/注入迹象 | 未发现 |
| ⑤ 作者/组织信誉 | Google 官方仓库，无造假迹象 |
| ⑥ License | Apache-2.0，明确 |
| ⑦ 最近维护时间 | 技能目录最近提交 2026-07-30，所属仓库整体最近提交 2026-08-14，持续维护中 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| Gke_Golden_Path_Google_Skills | 同仓库姊妹技能，提供 GKE 生产集群的推荐默认配置清单与 Day-0 就绪检查表 | 定位是“验证配置是否符合推荐默认值”的核对清单；本技能是“从零决定用什么模式、怎么创建、凭据怎么拿”的入门与决策指南，两者互补而非重叠——本技能明确把“高级集群架构”指向另一专项技能，把“配置基线核对”留给 Golden Path |
| Kubernetes_Skill | 平台无关的 K8s manifest 生产事故经验沉淀，覆盖 Kubernetes/EKS/GKE/AKS/OpenShift 等多平台失效模式诊断 | 面向“诊断已有 manifest 里的安全隐患”，产出是修复建议；本技能面向“创建一个新 GKE 集群该怎么选型、凭据怎么配”，是更早一步的入门与决策场景，且内容完全针对 GKE 原生特性（Autopilot 资源对齐规则等） |
| Azure_Kubernetes_Microsoft_Azure_Skills | Microsoft 官方 AKS（Azure Kubernetes Service）集群规划技能，区分 Day-0 难改决策与 Day-1 可后改特性 | 与本技能角色高度对应但服务不同云厂商——AKS 版本聚焦 SKU 选型（Automatic vs Standard），GKE 版本聚焦 Autopilot vs Standard 与 Workload Identity 等 GKE 原生概念，选型逻辑与具体命令均不可跨云套用 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；其所在的 google/skills 仓库曾有社区提交的维护性 PR 直接修正过本技能目录的 frontmatter 格式问题，仓库整体则于 2026 年 4 月 Google Cloud Next 大会由官方发布上线。
9. 其他补充
正文按“选型规则 → 关键坑位 → 参考目录”的结构组织，参考目录进一步拆分为核心概念、CLI/MCP 工具参考、客户端库、IaC 四个独立文件，用户可按需查阅而不必一次性读完全部内容。
10. 安装使用方式
- 一键安装：
npx skills add google/skills，安装过程中勾选 “GKE Basics”。 - 插件市场（Claude Code）：
claude plugin marketplace add google/skills，再执行claude plugin install <plugin>@google-plugins。 - 插件市场（Codex）：
codex plugin marketplace add google/skills，再从/plugins浏览器中选择安装。 - 手动安装：将仓库
skills/cloud/gke-basics/（含SKILL.md与references/子目录）复制到本地 agent 的 skills 目录。 - 使用前需完成
gcloud auth login认证，本机安装gcloudCLI；若要使用正文提及的 MCP 工具路径，需额外配置 GKE MCP 服务器。
11. 注意事项
- 内容聚焦“创建集群、选模式、拿凭据”这一入门环节；进阶集群架构与复杂节点池规划、专项网络配置、安全加固、版本升级分别指向同仓库的其他专项技能，正文已给出明确指路。
- Autopilot 资源请求必须按 250m（0.25 vCPU）整数倍对齐，未对齐的请求会被自动圆整，手动编写 YAML 时容易忽略这一细节。
- 使用 MCP 工具路径需要额外配置 GKE MCP 服务器；纯
gcloudCLI 路径无需此前置配置。