Helm 分环境 values 管理与模板函数实践

---

title: Helm 分环境 values 管理与模板函数实践

keywords: values, include, toYaml, nindent, required, default, tpl

description: 通过多环境值文件与模板函数提升 Chart 可维护性与一致性，规范渲染与参数校验。

categories:

• 文章资讯
• 办公技巧

---

示例 values-dev.yaml：

env: dev
image:
  repository: registry.example.com/app
  tag: dev-20250101
resources:
  requests:
    cpu: 200m
    memory: 256Mi
extra:
  featureX: true

示例 values-prod.yaml：

env: prod
image:
  repository: registry.example.com/app
  tag: v1.2.3
resources:
  requests:
    cpu: 500m
    memory: 512Mi
extra:
  featureX: false

模板片段（ConfigMap 与校验）：

apiVersion: v1
kind: ConfigMap
metadata:
  name: {{ include "app.fullname" . }}-config
data:
  APP_ENV: {{ .Values.env | quote }}
  IMAGE_REPO: {{ required "image.repository required" .Values.image.repository | quote }}
  IMAGE_TAG: {{ default "latest" .Values.image.tag | quote }}
  EXTRA: |
    {{- toYaml .Values.extra | nindent 4 }}

以 dev 环境安装/升级：

helm install app ./chart -f values-dev.yaml
helm upgrade app ./chart -f values-dev.yaml

使用 tpl 渲染可模板化值：

metadata:
  labels:
    rendered: {{ tpl "{{ .Values.env }}-label" . | quote }}