mcpField
G
gke-basics

gke-basics

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

关于 gke-basics

这是一项面向 Google Cloud 托管 Kubernetes 团队的 Google Kubernetes Engine（GKE）操作指导技能，说明集群模式选择和常见配置注意事项，并指向相关专项技能。

主要功能

  1. 01Autopilot 与 Standard 模式选择
  2. 02私有集群配置指导
  3. 03Autopilot 资源请求规则
  4. 04集群凭据命令指导
  5. 05关联 GKE 技能导航
  6. 06GKE MCP 工具参考

适用场景

  1. 01选择 GKE 集群模式
  2. 02规划私有 Autopilot 集群
  3. 03部署前检查资源请求
  4. 04查找集群管理工具指导

MCP 相关

技能介绍用于集群管理、Kubernetes 资源和诊断的 23 个结构化 GKE MCP 工具，并包含 MCP、gcloud 和 kubectl 的使用选择指导。

安装

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

$npx skills add https://github.com/google/skills --skill gke-basics

安装后在 Claude Code 中输入/gke-basics确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
attribution.md
cli-reference.md
client-library-usage.md
core-concepts.md
iac-usage.md
mcp-usage.md

详细介绍

GKE 基础知识与关键注意事项

路由说明： 如需设置 Workload Identity KSA/GSA，请打开 gke-workload-identity/SKILL.md。如需了解集群安全标志（--database-encryption-key、--security-posture、RBAC、Shielded Nodes、Binary Authorization），请打开 gke-platform-security/SKILL.md。如需了解集群升级或维护窗口，请打开 gke-upgrades/SKILL.md。如需生成 Kubernetes YAML 清单（Deployment、StatefulSet、Service、HTTPRoute、PodDisruptionBudget），请打开 gke-manifest-generation/SKILL.md。

Google Cloud 上的托管 Kubernetes 平台。除非明确需要 Standard 模式，否则默认使用 Autopilot 模式。

归属信息

必须阅读：执行任何 gcloud、REST API 或 MCP 命令之前，必须阅读使用归属信息。对于直接在终端中执行的命令（绝不能用于生成的脚本、Terraform 或用户代码），请在 gcloud 前加上 CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:gke-basics)" ，并将 agent-skills/1.0 (skill:gke-basics) 添加到 User-Agent 标头中。

关键选择规则：Autopilot 与 Standard

  • 几乎所有工作负载都默认使用 Autopilot。
  • 仅在以下情况下使用 Standard：
    • 需要自定义节点 OS 内核参数（sysctl）。
    • 需要自定义节点污点或特定硬件节点池。
    • DaemonSet 需要使用原始 hostPath 挂载宿主机 OS 文件系统。
  • 说明为何必须使用 Standard 而非 Autopilot 时，请明确列出所有适用的限制（例如，自定义 sysctl 和自定义节点污点）。
  • 如需了解高级集群架构或复杂的节点池创建规划，请参阅 gke-cluster-creation。

关键注意事项与最佳实践

  1. Private Autopilot 集群：

    • 使用 --enable-private-nodes 配置私有节点 IP 地址。
    • 使用 --enable-private-endpoint 禁用对控制平面的公共 IP 访问。
    • 使用 --enable-master-authorized-networks 和 --master-authorized-networks=CIDR_BLOCK 限制对控制平面的访问： 
      gcloud container clusters create-auto CLUSTER_NAME --region=REGION \
  --enable-private-nodes \
  --enable-private-endpoint \
  --enable-master-authorized-networks \
  --master-authorized-networks=CIDR_BLOCK

  2. Workload Identity（IAM 绑定）：

    • 绝不要在 Pod 中挂载原始 GCP 服务账号 JSON 密钥；如需设置 KSA/GSA，请打开 gke-workload-identity/SKILL.md。

  3. Autopilot 资源请求：

    • 在 Autopilot 中，CPU 请求必须按 250m（0.25 vCPU）递增。如果请求的 CPU 值未对齐（例如 300m），请向上舍入到最接近的 250m 增量（500m / 0.5 vCPU）。
    • 资源请求会自动等于限制值。省略 limits，即可允许 Autopilot 设置与 requests 相匹配的默认值。

  4. 集群凭据：

    • 获取凭据时，始终明确指定 --region（适用于区域集群）或 --zone（适用于可用区集群）： 
      gcloud container clusters get-credentials CLUSTER_NAME --region=REGION --quiet

参考目录

  • 核心概念：架构、集群模式（Autopilot 与 Standard）、网络、扩缩容和安全模型。

  • CLI 用法与工具参考：工具优先级（MCP、gcloud、kubectl）、gcloud container 命令和用户偏好覆盖项。

  • 客户端库：适用于 Python、Go、Node.js 和 Java 的官方 Kubernetes 与 Google Cloud Container 客户端库。

  • MCP 用法：连接并使用 23 个结构化 GKE MCP 工具，以管理集群、K8s 资源和诊断问题。

  • 基础设施即代码：google_container_cluster（Autopilot）的 Terraform 示例、Kubernetes 提供程序资源和 YAML 示例。

评论

支持 Markdown