CI/CD / 系统课时
用 Values 管理部署差异
用 Values 管理部署差异
同一个应用进入开发、测试和生产环境后,镜像标签、副本数、资源额度和 Service 配置往往不同。Helm Values 的关键作用,是把这些变化从 Kubernetes 模板中抽离,让一套模板能够通过不同参数生成不同环境的资源清单。
学习目标
- 判断哪些部署差异适合提取为 Values
- 设计清晰且可维护的 Values 参数层次
- 使用覆盖文件渲染并验证不同环境的 Kubernetes 清单
先区分结构与差异
不要为了“可配置”而把模板中的每个字段都提取成 Values。稳定的 Kubernetes 资源结构应该留在模板中,确实会因环境或发布变化的字段再参数化。
常见候选项包括镜像仓库与标签、副本数、资源 requests/limits、Service 类型和端口。标签选择器、容器基本结构等稳定约束则通常直接保留在模板中。
一份默认 values.yaml 可以按业务对象建立层次:
replicaCount: 2
image:
repository: example/myapp
tag: "1.0.0"
pullPolicy: IfNotPresent
service:
type: ClusterIP
port: 8080
resources:
requests:
cpu: 100m
memory: 128Mi
limits:
cpu: 500m
memory: 512Mi这里把同一职责的字段放在同一对象下,比 imageRepository、servicePort、limitMemory 等大量扁平键更容易阅读,也方便模板表达字段所属关系。
在模板中消费 Values
Deployment 可以直接读取镜像、副本数和资源配置。下面是片段示例,依赖完整 Deployment 的 selector、Pod 模板、标签等上下文:
spec:
replicas: {{ .Values.replicaCount }}
template:
spec:
containers:
- name: app
image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
imagePullPolicy: {{ .Values.image.pullPolicy }}
resources:
{{- toYaml .Values.resources | nindent 12 }}toYaml 把 resources 对象转换成 YAML,nindent 12 再把生成内容缩进到当前字段需要的位置。这种方式适合直接传递结构化 Kubernetes 配置,避免逐项重复模板代码。
Service 同样只消费与自己相关的参数:
apiVersion: v1
kind: Service
metadata:
name: {{ .Release.Name }}-myapp
spec:
type: {{ .Values.service.type }}
ports:
- port: {{ .Values.service.port }}
targetPort: {{ .Values.service.port }}这是片段示例,实际 Chart 还需要与 Pod 标签一致的 selector。模板定义“资源怎样组成”,Values 定义“这次部署使用什么值”,两者职责不要反过来。
用覆盖文件表达环境差异
默认 Values 应提供合理基线,环境文件只覆盖真正不同的字段。例如生产环境需要更多副本和资源,可以创建 values-prod.yaml:
replicaCount: 4
image:
tag: "1.3.2"
resources:
requests:
cpu: 500m
memory: 512Mi
limits:
cpu: "1"
memory: 1GiHelm 会把覆盖文件与 Chart 默认 Values 合并,因此没有在 values-prod.yaml 重写的 image.repository、service 等字段仍沿用默认值。这样比复制完整 Values 文件更容易看出环境到底改了什么。
假设 Chart 位于 ./myapp,可以渲染生产配置而不安装资源:
helm template myapp ./myapp -f ./myapp/values-prod.yaml预期结果
# Source: myapp/templates/...
apiVersion: ...
kind: ...
...实际输出取决于 Chart 模板。验证时不要只看命令是否成功,还应检查渲染后的 Deployment 是否为 4 个副本、镜像标签是否为 1.3.2,以及 CPU、内存限制是否符合生产配置。
控制 Values 的边界
Values 适合表达部署参数,但不应成为随意塞入所有数据的容器。尤其不要把密码、令牌或私钥以明文方式提交到普通 Git Values 文件;在 GitOps 场景中,应结合团队采用的 Secret 管理方案处理敏感数据。
命名也应保持稳定。例如已经采用 image.repository 和 image.tag 后,不要在另一个环境中改成新的键名;环境文件应该覆盖值,而不是改变参数模型。
检查最终使用的值
除了观察完整清单,还可以让 Helm 展示合并后的 Values:
helm template myapp ./myapp -f ./myapp/values-prod.yaml --debug预期结果
install.go: ... [debug] ...
...
COMPUTED VALUES:
...
replicaCount: 4
...--debug 的日志前缀、源码位置和具体文本会随 Helm 版本变化,应以实际输出为准;关键是检查 COMPUTED VALUES 与最终渲染资源。设计良好的 Values 应让读者仅查看默认值和环境覆盖文件,就能迅速判断一次部署改变了哪些关键运行参数,而不必复制或修改整套 Kubernetes 模板。