CI/CD / 系统课时

用 Values 管理部署差异

用 Values 管理部署差异

同一个应用进入开发、测试和生产环境后,镜像标签、副本数、资源额度和 Service 配置往往不同。Helm Values 的关键作用,是把这些变化从 Kubernetes 模板中抽离,让一套模板能够通过不同参数生成不同环境的资源清单。

学习目标

  • 判断哪些部署差异适合提取为 Values
  • 设计清晰且可维护的 Values 参数层次
  • 使用覆盖文件渲染并验证不同环境的 Kubernetes 清单

先区分结构与差异

不要为了“可配置”而把模板中的每个字段都提取成 Values。稳定的 Kubernetes 资源结构应该留在模板中,确实会因环境或发布变化的字段再参数化。

常见候选项包括镜像仓库与标签、副本数、资源 requests/limits、Service 类型和端口。标签选择器、容器基本结构等稳定约束则通常直接保留在模板中。

一份默认 values.yaml 可以按业务对象建立层次:

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 模板、标签等上下文:

yaml
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 同样只消费与自己相关的参数:

yaml
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:

yaml
replicaCount: 4

image:
  tag: "1.3.2"

resources:
  requests:
    cpu: 500m
    memory: 512Mi
  limits:
    cpu: "1"
    memory: 1Gi

Helm 会把覆盖文件与 Chart 默认 Values 合并,因此没有在 values-prod.yaml 重写的 image.repository、service 等字段仍沿用默认值。这样比复制完整 Values 文件更容易看出环境到底改了什么。

假设 Chart 位于 ./myapp,可以渲染生产配置而不安装资源:

bash
helm template myapp ./myapp -f ./myapp/values-prod.yaml

预期结果

text
# Source: myapp/templates/...
apiVersion: ...
kind: ...
...

实际输出取决于 Chart 模板。验证时不要只看命令是否成功,还应检查渲染后的 Deployment 是否为 4 个副本、镜像标签是否为 1.3.2,以及 CPU、内存限制是否符合生产配置。

控制 Values 的边界

Values 适合表达部署参数,但不应成为随意塞入所有数据的容器。尤其不要把密码、令牌或私钥以明文方式提交到普通 Git Values 文件;在 GitOps 场景中,应结合团队采用的 Secret 管理方案处理敏感数据。

命名也应保持稳定。例如已经采用 image.repository 和 image.tag 后,不要在另一个环境中改成新的键名;环境文件应该覆盖值,而不是改变参数模型。

检查最终使用的值

除了观察完整清单,还可以让 Helm 展示合并后的 Values:

bash
helm template myapp ./myapp -f ./myapp/values-prod.yaml --debug

预期结果

text
install.go: ... [debug] ...
...
COMPUTED VALUES:
...
replicaCount: 4
...

--debug 的日志前缀、源码位置和具体文本会随 Helm 版本变化,应以实际输出为准;关键是检查 COMPUTED VALUES 与最终渲染资源。设计良好的 Values 应让读者仅查看默认值和环境覆盖文件,就能迅速判断一次部署改变了哪些关键运行参数,而不必复制或修改整套 Kubernetes 模板。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Values 管理部署差异

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

登录哪都通