CI/CD / 系统课时
设计可维护的 Values 层次
设计可维护的 Values 层次
当开发、测试和生产共用一个 Chart 时,最容易失控的不是模板,而是 Values:默认值、环境差异和密码混在一个文件里,很快就会出现复制粘贴和配置漂移。合理分层的目标是让 Chart 保持通用,同时让环境差异明确可追踪。
学习目标
- 区分 Chart 默认值、环境覆盖值和敏感参数的职责
- 利用 Helm 多个 Values 文件的覆盖顺序组织环境配置
- 避免把密钥和环境特有信息固化进通用
values.yaml
把配置分成三个职责层
Chart 自带的 values.yaml 应保存安全、通用且能表达 Chart 默认行为的配置,例如副本数、服务端口和资源字段的默认结构。开发或生产环境的差异放入独立 Values 文件,而密码、令牌和私钥不应因为方便就直接写入普通 Git 文件。

例如,默认文件可以保留不绑定具体环境的值:
replicaCount: 1
image:
repository: example/myapp
tag: stable
service:
port: 8080
resources: {}这是配置文件示例,不产生控制台输出。验证方法是执行 helm template,确认模板能够使用这些默认值正常渲染;真实项目中的镜像仓库和标签应替换为实际可用值。
环境文件只描述差异
生产环境不需要复制整个默认文件,只覆盖真正不同的部分。例如 values-prod.yaml 可以只调整副本数和资源限制:
replicaCount: 3
resources:
requests:
cpu: 200m
memory: 256Mi
limits:
cpu: 500m
memory: 512Mi这种组织方式让评审者看到的主要是“生产环境改了什么”,而不是两份几乎相同的大文件。默认值发生变化时,也不必同步修改所有环境文件。
可以同时加载多个文件验证覆盖行为。Helm 对多个 -f 参数按顺序处理,后面的文件具有更高优先级:
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 只保存引用:
database:
existingSecret: myapp-database
passwordKey: password这是配置片段示例,依赖模板已经实现对 database.existingSecret 和 database.passwordKey 的读取。它的生效行为应是工作负载引用名为 myapp-database 的 Secret,而不是由普通 Values 文件携带密码明文。
敏感数据具体由哪种系统提供取决于团队的 GitOps 方案,可以来自集群预置 Secret 或专门的密钥管理流程。关键边界是:Chart 定义如何引用秘密,环境系统负责提供秘密本身。
检查最终合并结果
Values 分层后,排错时不要只打开某一个文件猜测最终值。应直接渲染目标环境,再检查最终 Kubernetes 清单:
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预期输出取决于模板生成的实际行号和镜像名称,但应能看到生产副本数与最终镜像,例如:
<ID>: replicas: 3
<ID>: image: "example/myapp:2026.09.20"其中 <ID> 表示实际行号可能不同。若结果不符合预期,应沿覆盖顺序检查默认 Values、环境文件和命令行覆盖,而不是直接修改模板绕过配置问题。
可维护的 Values 层次最终应做到三件事:默认文件表达 Chart 的通用行为,环境文件只保存环境差异,敏感值由独立机制管理。这样同一个 Chart 才能跨环境复用,同时保持变更范围清晰、可评审和可验证。