helm-diff 插件用于预览 kubernetes 应用升级前的 yaml 差异，支持对比已部署 release 与本地 chart、或两个 chart 版本渲染结果，可集成 ci/cd 作为部署门禁，但不校验 crd 逻辑变更。
在 Kubernetes 中使用 Helm 部署应用前，确认 Chart 模板变更是否符合预期，是避免误发布的关键一步。Helm-Diff 插件能以清晰、结构化的方式展示 当前已部署版本 与 即将部署的新版本 在渲染后 YAML 上的差异，本质是“预览变更”，而非执行部署。
安装 Helm-Diff 插件
Helm-Diff 是官方推荐的插件（由 [databus23/helm-diff](https://github.com/databus23/helm-diff) 维护），支持 Helm 3 和 Helm 4：
- 推荐用
helm plugin install安装（自动适配 Helm 版本）：helm plugin install https://github.com/databus23/helm-diff - 如遇网络问题，可下载 release 包手动安装（注意匹配 Helm 主版本）
- 安装后运行
helm diff version验证是否就绪
基础对比命令：diff 已部署 Release 与本地 Chart
最常用场景：对比集群中正在运行的 Release 和你本地修改后的 Chart（含 values.yaml 变更）：
helm diff upgrade <release_name><chart_path> --values values-prod.yaml</chart_path></release_name>- 若 Release 使用了命名空间，务必加
--namespace <ns></ns> - 支持
--detailed-exitcode：无变化返回 0，有差异返回 2（可用于 CI 流水线判断是否需人工审核） - 默认只显示新增/删除/变更的资源块；加
--no-color适合日志归档，--context=3可调整上下文行数
对比两个不同 Chart 版本（不依赖集群状态）
有时你想验证 Chart 自身迭代（比如 v1.2.0 → v1.3.0）带来的模板变动，而无需集群中有对应 Release：
- 先用
helm template渲染两个版本的完整 manifest：helm template myapp ./chart -f values.yaml --version 1.2.0 > old.yamlhelm template myapp ./chart -f values.yaml --version 1.3.0 > new.yaml - 再用
helm diff manifest old.yaml new.yaml直接比对两份 YAML 文件 - 该方式完全离线，适合 PR 检查或本地快速验证
集成到 CI/CD 流程中的实用建议
将 diff 作为部署前强制门禁，可显著降低配置漂移风险：
- 在 GitHub Actions / GitLab CI 中，先运行
helm diff upgrade并捕获退出码 - 若返回 2（存在差异），可自动输出 diff 结果到日志，并要求 PR 添加变更说明
- 敏感环境（如 prod）建议配合
--suppress-secrets隐藏 Secret 内容，避免泄露 - 注意：diff 不校验 CRD 或自定义资源逻辑变更，仅比对最终 YAML 结构——CRD 升级仍需单独验证
掌握 Helm-Diff 的核心逻辑就是理解它在 “渲染 → 对比 → 呈现” 这一链路中精准卡位。它不替代测试，但能让你在 敲下 helm upgrade 之前，真正看清改了什么。
