helm-chart-scaffolding

Helm Chart 脚手架

为打包和部署 Kubernetes 应用而创建、组织和管理 Helm Chart 的全面指南。

目的

本技能提供构建生产就绪的 Helm Chart 的分步说明，包括 Chart 结构、模板模式、values 管理和验证策略。

何时使用本技能

在以下情况下使用本技能：

• 从零开始创建新的 Helm Chart
• 打包 Kubernetes 应用以便分发
• 使用 Helm 管理多环境部署
• 为可复用的 Kubernetes 清单实现模板化
• 搭建 Helm Chart 仓库
• 遵循 Helm 最佳实践和约定

详细模式与完整示例

详细的模式文档位于 references/details.md。当上述导航层级不够用时，请阅读该文件。

最佳实践

1. 对 Chart 版本和应用版本使用语义化版本控制
2. 在 values.yaml 中通过注释记录所有 values
3. 对重复逻辑使用模板辅助函数
4. 打包前验证 Chart
5. 显式固定依赖版本
6. 对可选资源使用条件判断
7. 遵循命名约定（小写、连字符）
8. 包含 NOTES.txt 并附上使用说明
9. 使用辅助函数一致地添加标签
10. 在所有环境中测试安装

故障排除

模板渲染错误：

helm template my-app ./my-app --debug

依赖问题：

helm dependency update
helm dependency list

安装失败：

helm install my-app ./my-app --dry-run --debug
kubectl get events --sort-by='.lastTimestamp'

相关技能

• k8s-manifest-generator - 用于创建基础 Kubernetes 清单
• gitops-workflow - 用于自动化 Helm Chart 部署