Linux kube-bench 的 –auto 模式与自定义 benchmark yaml 扩展

1次阅读

auto 模式不读自定义 yaml 是因为它自动探测节点角色后硬编码加载内置 cfg/master.yaml 或 cfg/node.yaml,完全忽略 –benchmark 和 –config-dir 参数;想用自定义 yaml 必须关闭 –auto 并显式指定 –benchmark 路径。

Linux kube-bench 的 –auto 模式与自定义 benchmark yaml 扩展

为什么 --auto 模式不读你放的自定义 YAML

kube-bench--auto 模式本质是自动探测当前节点角色(masternode),然后硬编码加载对应内置 benchmark 文件,比如 cfg/master.yaml。它完全跳过 --benchmark--config-dir 参数,也不扫描你本地的 YAML 文件。

常见错误现象:kube-bench --benchmark my-custom.yaml --auto 运行结果和没加 --benchmark 一样;或者把自定义 YAML 放进 --config-dir 后仍被忽略。

  • --auto--benchmark / --config-dir 是互斥的,后者在前者开启时直接失效
  • 想用自定义 YAML,必须显式指定 --benchmark,且不能带 --auto
  • 内置 benchmark 路径固定为 cfg/ 下的 master.yamlnode.yaml 等,不会从当前目录或任意路径加载

如何让自定义 benchmark YAML 生效(不靠 --auto

核心逻辑:关闭自动探测,手动指定配置路径。只要 --benchmark 指向一个合法 YAML,kube-bench 就会加载它并按其中定义的 controls 执行检查。

使用场景:你想增加一条检查容器运行时是否启用 seccomp,或跳过某条已知不适用的 CIS 规则。

  • YAML 必须包含顶层字段 controls,每个 control 需有 idtexttest_items 等基本结构
  • 文件路径支持相对路径,例如 --benchmark ./my-node-checks.yaml
  • 如果 YAML 中引用了 tests 下的命令,注意 cmd 字段里用的 shell 命令需在目标节点环境存在(如 kubectlcrictl
  • 建议先用 --no-remediation 测试输出,确认 control 被识别且 test_item 返回预期结果

自定义 YAML 里改 test_itemscmd 容易踩的坑

test_items.cmd 看似只是写个 shell 命令,但实际执行时受 kube-bench 的运行上下文严格约束:它默认以非 root 用户启动,且不加载用户 shell 配置(.bashrc$PATH 可能不完整)。

典型错误现象:本地测试 crictl ps 成功,放到 YAML 里却报 command not found;或 kubectl get nodes 因权限不足失败。

  • 所有命令必须用绝对路径,例如 /usr/bin/crictl 而非 crictl
  • 避免依赖环境变量,cmd 中不要写 $HOME 或未导出的变量
  • 若需 kubectl 权限,确保 kube-bench 进程能读取 ~/.kube/config,或显式用 --kubeconfig 参数传入
  • 返回值判断只看 exit code:0 为通过,非 0 为失败;stdout/stderr 不参与判定,仅用于日志输出

扩展 benchmark 时要不要动 cfg/ 目录里的内置文件

不建议直接修改 cfg/ 下的内置 YAML。这些文件随 kube-bench 版本更新而覆盖,你的修改会被清空,且难以做版本比对和协作复用。

更稳妥的做法是维护独立 YAML,并通过 --benchmark 显式加载。如果确实需要长期复用多个扩展项,可考虑:

  • 把自定义 YAML 放进 git 仓库,CI/CD 中统一拉取
  • include 字段(v0.6.0+ 支持)引用其他 YAML 片段,但注意嵌套层级不能太深
  • 若要兼容多版本 kubernetes,注意内置 benchmark 中 version 字段与你集群的匹配性,自定义 YAML 可省略该字段,由 --version 参数统一控制

真正麻烦的是 test_item 的稳定性——CIS 规则本身会变,Kubernetes 组件输出格式也会变,一条写死的 grep -q 'seccomp' 很可能在下个小版本就失效。得盯着上游变更,而不是只管 YAML 文件有没有被加载。

text=ZqhQzanResources