CI/CD / 系统课时

设计可维护的 Values 层次

设计可维护的 Values 层次

当开发、测试和生产共用一个 Chart 时,最容易失控的不是模板,而是 Values:默认值、环境差异和密码混在一个文件里,很快就会出现复制粘贴和配置漂移。合理分层的目标是让 Chart 保持通用,同时让环境差异明确可追踪。

学习目标

  • 区分 Chart 默认值、环境覆盖值和敏感参数的职责
  • 利用 Helm 多个 Values 文件的覆盖顺序组织环境配置
  • 避免把密钥和环境特有信息固化进通用 values.yaml

把配置分成三个职责层

Chart 自带的 values.yaml 应保存安全、通用且能表达 Chart 默认行为的配置,例如副本数、服务端口和资源字段的默认结构。开发或生产环境的差异放入独立 Values 文件,而密码、令牌和私钥不应因为方便就直接写入普通 Git 文件。

Helm Values 分层与覆盖关系

例如,默认文件可以保留不绑定具体环境的值:

yaml
replicaCount: 1

image:
  repository: example/myapp
  tag: stable

service:
  port: 8080

resources: {}

这是配置文件示例,不产生控制台输出。验证方法是执行 helm template,确认模板能够使用这些默认值正常渲染;真实项目中的镜像仓库和标签应替换为实际可用值。

环境文件只描述差异

生产环境不需要复制整个默认文件,只覆盖真正不同的部分。例如 values-prod.yaml 可以只调整副本数和资源限制:

yaml
replicaCount: 3

resources:
  requests:
    cpu: 200m
    memory: 256Mi
  limits:
    cpu: 500m
    memory: 512Mi

这种组织方式让评审者看到的主要是“生产环境改了什么”,而不是两份几乎相同的大文件。默认值发生变化时,也不必同步修改所有环境文件。

可以同时加载多个文件验证覆盖行为。Helm 对多个 -f 参数按顺序处理,后面的文件具有更高优先级:

bash
helm template myapp ./myapp \
  -f ./myapp/values.yaml \
  -f ./myapp/values-prod.yaml \
  --set image.tag=2026.09.20 \
  > /tmp/myapp-prod.yaml

预期结果:命令成功时终端通常没有输出,因为渲染结果被写入 /tmp/myapp-prod.yaml;退出码为 0。最终值中 replicaCount 为 3,资源限制来自 values-prod.yaml,image.tag 则由命令行的 --set 覆盖为 2026.09.20。

敏感参数不要混入普通 Values

Values 本身不是秘密存储机制。把数据库密码直接写入 values-prod.yaml,即使模板最终生成 Kubernetes Secret,明文仍可能存在于 Git 历史、代码评审和 CI 日志中。

更稳妥的设计是让 Chart 接受一个已有 Secret 的名称,而不是接受明文密码。例如 Values 只保存引用:

yaml
database:
  existingSecret: myapp-database
  passwordKey: password

这是配置片段示例,依赖模板已经实现对 database.existingSecret 和 database.passwordKey 的读取。它的生效行为应是工作负载引用名为 myapp-database 的 Secret,而不是由普通 Values 文件携带密码明文。

敏感数据具体由哪种系统提供取决于团队的 GitOps 方案,可以来自集群预置 Secret 或专门的密钥管理流程。关键边界是:Chart 定义如何引用秘密,环境系统负责提供秘密本身。

检查最终合并结果

Values 分层后,排错时不要只打开某一个文件猜测最终值。应直接渲染目标环境,再检查最终 Kubernetes 清单:

bash
helm template myapp ./myapp \
  -f ./myapp/values-prod.yaml \
  --set image.tag=2026.09.20 \
  > /tmp/myapp-prod.yaml

grep -nE 'replicas:|image:' /tmp/myapp-prod.yaml

预期输出取决于模板生成的实际行号和镜像名称,但应能看到生产副本数与最终镜像,例如:

text
<ID>:  replicas: 3
<ID>:        image: "example/myapp:2026.09.20"

其中 <ID> 表示实际行号可能不同。若结果不符合预期,应沿覆盖顺序检查默认 Values、环境文件和命令行覆盖,而不是直接修改模板绕过配置问题。

可维护的 Values 层次最终应做到三件事:默认文件表达 Chart 的通用行为,环境文件只保存环境差异,敏感值由独立机制管理。这样同一个 Chart 才能跨环境复用,同时保持变更范围清晰、可评审和可验证。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设计可维护的 Values 层次

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通