
k8s-guardian 发布 v0.7:在部署前发现 Kubernetes YAML 的集群级问题
来源标题:Why valid Kubernetes YAML still breaks in prod and how to catch it before deploy
k8s-guardian v0.7 能结合集群上下文(配额、节点规格、LimitRange、引用的 Secret 和 CRD)与线上资源 diff,在部署前发现通过 lint 但会在集群中失败的问题,并只自动修复安全的项。作者在 30 个热门 Helm chart 上测试时发现工具自身 5 个 bug,均已修复。同一套规则还可导出为准入策略,使 CI 与集群保持一致。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
2026-06 · 工程 · #kubernetes · Andrii Zhukovskyi
对 manifest 做 lint 检查,检查的是文件本身,而不是它将要部署到的集群。要捕捉部署时的失败,你还需要集群的上下文(配额、节点规格、LimitRanges、它引用的 Secret 和 CRD),以及与当前正在运行的对象的 diff。k8s-guardian 两者都做,只修复可以安全修复的内容,并把同一套规则导出为 admission 策略,让 CI 和集群的判断保持一致。在 30 个热门 Helm chart 上运行它,发现了工具自身的五个 bug,均已修复。
在工作中,我在十多个环境里定义了部署和配置标准。标准有帮助,但没有任何东西强制执行它们,所以每隔几周就会有东西漂移:一个 Helm value、一个资源限制、一个被遗忘的 feature flag。更糟的是那些通过了所有检查、却在部署时失败的变更。我在 7 月写下这篇文章的第一版时,它还只是一个计划。这是计划最终变成的样子:k8s-guardian,现在到了 v0.7。
因为“valid”是文件的属性,而大多数失败是集群的属性。我一直在手动回答的问题有这些:
k8s-guardian check -f k8s/ # 文件、chart、Kustomize k8s-guardian check -f k8s/ --fix # 应用安全修复 k8s-guardian check -f k8s/ --live -n prod # 它能装进集群吗? k8s-guardian diff -f k8s/ -n prod # 如果我应用它,什么会坏? k8s-guardian export vap > guardrails.yaml # 在 admission 阶段使用同样的规则
在 30 个 Helm chart 上运行它教会了我什么
手写的示例会美化一个工具。所以我让 k8s-guardian 针对 30 个广泛使用的 Helm chart 运行,其中包括 ingress-nginx、kube-prometheus-stack、Argo CD、cert-manager、Vault 和 Longhorn:总共 652 个 Kubernetes 对象。它在 k8s-guardian 自身中发现了五个 bug。
五个都已修复,每个都配有回归测试,并且有一个每周工作流在固定版本的 chart 上重复这次运行,使它们无法复发。
只修复那些不会改变工作负载运行方式的项。表格中的最后一个 bug 是最重要的一个:一个自动修复在 Longhorn 的 manager 上设置了 privileged: false,随后 API server 拒绝了它,还从 node-exporter 移除了 hostNetwork,导致它无法工作。现在 --fix 只应用安全修复,并把未改动的文档逐字节写回,包括注释。任何可能改变行为的操作,例如强制非 root、只读文件系统或资源值,都需要 --fix --unsafe-fixes 并经过审查。特权容器和 host 命名空间会被报告,但永远不会被修改。
把它们导出。export vap 会把规则写为 ValidatingAdmissionPolicies,export kyverno 会写为 Kyverno 策略,经过测试,它们做出与 CLI 相同的判断。同一个二进制还可以作为 GitHub Action 运行,带 PR 注解和 SARIF,也可以作为 pre-commit hook、kubectl 插件,以及面向 AI 编程助手的 MCP server。
源码和文档:github.com/andronaft/k8s-guardian(Apache 2.0)· 完整的 chart 运行记录:real-world test
关于这个工具:k8s-guardian,懂你集群的 kubernetes guardrails。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。