1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | gke-storage-google-skills |
| 作者/维护者 | Google（google/skills 官方仓库） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/gke-storage |
| 许可证 | Apache-2.0（GitHub API 获取，适用于整个仓库） |
| GitHub Stars | 19,049（GitHub API 获取；该数字属整个 google/skills 合集仓库，不代表本技能自身热度） |
| Forks | 1,541（GitHub API 获取，同为合集整体数据） |
| 最新版本 | 无独立版本号；技能目录最近一次提交于 2026-06-24（GitHub API 获取） |
| 安装方式 | npx skills add google/skills 后勾选 “GKE Storage”，或手动复制 skills/cloud/gke-storage 目录 |
2. 功能介绍与亮点
这是一个专注于 GKE（Google Kubernetes Engine）集群存储配置的技能，覆盖持久化磁盘、共享文件存储与对象存储挂载三条路径。核心能力包括：
- 黄金路径存储驱动表：列出 Autopilot 默认启用的四种 CSI 驱动（Compute Engine 持久盘、Filestore、Cloud Storage FUSE、Parallelstore），逐项标注访问模式（ReadWriteOnce / ReadWriteMany）与适用场景，帮助按工作负载类型选对存储方式而非试错。
- 内置 StorageClass 速查与自定义模板：给出
standard-rwo/premium-rwo等内置 StorageClass 与磁盘类型、成本的对应关系，并提供带regional-pd跨区域复制、WaitForFirstConsumer绑定模式的自定义 StorageClass YAML 模板。 - 三种 PVC 配置范式：块存储（单 Pod 数据库场景）、Filestore 共享文件存储（多 Pod 读写）、GCS FUSE 直接挂载（无需 PVC，用 Workload Identity 授权）均给出可直接套用的 YAML，覆盖典型存储需求的完整配置面。
- 容量在线扩容说明：给出
kubectl patch扩容 PVC 的具体命令，并说明前提是 StorageClass 已启用allowVolumeExpansion。 - 七条最佳实践清单：从“始终启用卷扩容”到“用 Backup for GKE 备份 PVC”，把易漏配置项前置提醒，并指向配套的
gke-backup-dr技能做灾备。
3. 适用场景
所属分类：DevOps 与基础设施
适用于为 GKE 集群配置数据持久化方案的平台工程师、SRE 与应用开发者：无论是给数据库配置块存储、给多副本应用配置共享文件系统，还是把 GCS 存储桶直接挂载进 Pod 做 ML 训练数据读取，均可依据本技能的黄金路径默认值与 YAML 模板直接落地，无需自行比对 CSI 驱动文档。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 ✅ | SKILL.md 遵循 Agent Skills 规范（YAML frontmatter + 纯 Markdown 正文） |
| Codex | 原生支持 ✅ | Codex CLI 读取同一 SKILL.md 目录结构，google/skills 官方安装文档明确列出该目标 |
| OpenClaw | 原生支持 ✅ | 采用相同的 AgentSkills SKILL.md 规范，结构可直接迁移 |
| Hermes Agent | 原生支持 ✅ | 遵循 agentskills.io 开放标准，跨兼容框架可移植 |
⚠️ 正文提及的 MCP 工具（get_cluster、patch_k8s_resource 等）为可选加速路径，正文命令均以 kubectl/YAML 形式给出，未接入对应 MCP 时技能仍可通过命令行独立完整工作。
5. 推荐理由
GKE 存储配置涉及四种 CSI 驱动与多种访问模式的取舍，选错容易导致后期迁移成本高（如误用 ReadWriteOnce 磁盘却需要多 Pod 共享）。本技能把驱动选型、StorageClass 配置、三类典型 PVC 场景与扩容操作压缩成一份可直接复制的参考清单，帮助在写 YAML 之前先把存储架构想清楚。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 Google 是 GKE 产品与技术的所有者；google/skills 属合集仓库，19,049 星属整个仓库，不计入单个子技能，未查到该子技能自身独立于合集之外的第三方讨论 |
| 可用性 | 9 | 单文件 SKILL.md 即可用，黄金路径表格 + 可直接套用的 YAML/kubectl 命令覆盖三类典型存储场景，2026-06-24 有更新、维护活跃，无付费依赖（仅需已有的 GCP 项目） |
| 安全性 | 9 | 纯配置指导，无外发数据；给出的命令权限范围（PVC/StorageClass 增删改）与存储配置目的一致，GCS FUSE 挂载显式要求 Workload Identity 最小权限授权，开源可审计；见下方检查清单 |
综合评分：8.33
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 仅 kubectl/gcloud 存储相关命令（创建/查看/patch PVC、StorageClass），权限范围与存储配置目的一致 |
| ② 运行时联网外发 | 无向第三方服务器外发数据，仅与用户自己的 GCP 项目交互 |
| ③ API Key/凭据 | 不要求硬编码密钥，GCS FUSE 场景依赖 Workload Identity 标准授权流程 |
| ④ 可疑指令 | 通读全文未发现夹带无关推广或索取凭据的指令 |
| ⑤ 作者信誉 | Google 官方仓库，GKE 产品团队维护，无造假迹象 |
| ⑥ License | Apache-2.0，明确开源 |
| ⑦ 最近维护 | 2026-06-24 有更新，维护活跃 |
7. 跟同类 Skills 相比的优势
| 技能 | 覆盖范围 | 特点 |
|---|---|---|
| gke-storage-google-skills（本技能） | GKE 集群存储层（PVC、StorageClass、Filestore、GCS FUSE） | 聚焦卷供给与挂载配置，覆盖块/文件/对象三类存储路径的选型与 YAML 模板 |
| gke-networking-google-skills | GKE 集群网络层（私有集群、VPC、IP 规划） | 覆盖建集群前必须定好的网络决策，与存储配置分工互补、不重叠 |
| gke-backup-dr-google-skills | PVC 备份与灾难恢复 | 面向已配好的存储做保护与恢复，依赖本技能先完成卷供给 |
| Google Cloud Storage Basics Google Skills | GCS 对象存储的通用操作（桶管理、生命周期规则） | 面向独立于 Kubernetes 之外的 GCS 使用场景，本技能只覆盖 GCS 作为 GKE 卷挂载的场景 |
存储选型是 GKE 部署中容易被忽视却难以事后修改的一环（如把数据库跑在 ReadWriteMany 卷上会造成性能损耗），本技能把四种驱动的适用边界提前列清楚，并与负责备份恢复的 gke-backup-dr-google-skills、面向纯 GCS 操作的 Google Cloud Storage Basics 形成互补，不构成重复收录。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 安装使用方式
- 通用安装：
npx skills add google/skills，交互式勾选 “GKE Storage” 后自动写入当前 agent 的技能目录。 - 手动安装：直接复制仓库中的
skills/cloud/gke-storage/SKILL.md文件到所用 agent 的技能目录下。 - 使用前提：需已开通 Google Cloud 项目并完成
gcloud auth login；若使用 MCP 加速路径，需额外配置对应的 GKE MCP 工具。 - 触发方式：向 agent 提出“帮我配置 GKE 持久化存储”或“给 GKE 挂载 GCS 桶”类请求即可触发，无需重启 agent。
10. 注意事项
- Filestore 共享存储 Basic 档最小容量为 1 TiB，容量规划需提前核对，避免小规模场景因最低起订量造成成本浪费。
- GCS FUSE 挂载依赖 Workload Identity 完成授权，未提前配置好服务账号绑定会导致 Pod 无法读取存储桶。
- MCP 工具路径依赖用户自行配置对应的 GKE MCP 服务器，未配置时可直接使用文中提供的
kubectl/YAML 方式。