mcpField
K
kubernetes-helm

kubernetes-helm

github.com/blogic-cz云与 DevOps375 次安装今天更新
代码仓库

关于 kubernetes-helm

一项用于在测试和生产 Kubernetes 环境中采用一致 Helm 模式的技能。它按项目约定指导图表修改、环境变量、密钥、资源设置及运行时检查。

主要功能

  1. 01编辑测试和生产图表配置
  2. 02按字母顺序排列 extraEnvVars
  3. 03通过引用使用密钥而不内嵌
  4. 04配置探针与 CronJob
  5. 05使用 k8s-tool 执行运行时检查

适用场景

  1. 01更新 Helm 图表中的环境变量
  2. 02为作业和钩子配置密钥
  3. 03检查探针和资源设置
  4. 04使用 k8s-tool 检查 Kubernetes 环境

安装

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

$npx skills add https://github.com/blogic-cz/blogic-marketplace --skill kubernetes-helm

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

附带文件references/chart-structure.mdreferences/helm-examples.md

详细介绍

Kubernetes 与 Helm 工作流

在测试和生产 Kubernetes 环境中应用一致的 Helm 模式。

适用场景

  • 更新 Helm values 文件
  • 添加或更改环境变量
  • 配置资源、探针、入口、安全、作业或 cronjob
  • 使用 Kubernetes secrets、命名空间、pod 和环境 URL

遵循此工作流

  1. 在 kubernetes/helm/ 中找到目标 chart；除非更改仅针对特定环境，否则同时编辑 values.test.yaml 和 values.prod.yaml。
  2. 在 extraEnvVars 下添加非敏感变量，并使用直接的 value；条目按字母顺序排列。
  3. 使用 valueFrom.secretKeyRef 添加敏感变量；切勿将密钥直接写入 values 文件。
  4. 通过 chart values 键 hooks.secretName（在 values.*.yaml 中）定义 hook/job 密钥，然后在 hook 模板中使用它（例如迁移/同步作业）。
  5. 如果仓库使用本地 env 文件，请在 .env.example 和 .env 中同步添加新变量，并使用安全的占位默认值。
  6. 部署前检查 chart 特定的密钥命名和命名空间约定。
  7. 只有满足前置条件后，才使用 k8s-tool 进行运行时检查：k8s-tool 是项目的 kubectl 封装工具，提供环境快捷方式；使用它需要已安装 CLI，并具备有效的 kubeconfig/集群访问权限。

参考资料

请阅读以下文件中的具体片段和 YAML 示例：

  • references/chart-structure.md
  • references/helm-examples.md

关键规则

  1. 保持 extraEnvVars 按字母顺序排列
  2. 切勿提交密钥——使用带有 secretKeyRef 的 K8s secrets
  3. 测试环境的 values 设置应较为保守——资源配置应低于生产环境
  4. 使用适当的探针路径——存活探针使用 /api/alive，就绪探针使用 /api/health
  5. CronJobs 必须设置 concurrencyPolicy: Forbid，以防止重叠运行

评论

支持 Markdown