4. Values 默认值设计：default 函数、required 函数、条件默认值、多环境默认值策略

在生产级 Helm Chart 中，Values 文件是配置的入口，但用户可能遗漏关键参数或传入非法值。本章聚焦于如何通过 default、required、条件默认值 和 多环境默认值策略 来构建健壮、可复用的 Values 体系，确保 Chart 在不同集群环境下都能稳定运行。

4.1 default 函数：安全降级的基础

default 是 Helm 模板中最常用的内置函数，当指定路径的值为空或不存在时，返回一个预设的兜底值。其语法为：

{{ default "fallback_value" .Values.some.path }}

典型使用场景包括：

• 镜像标签：用户未指定时默认使用 latest。
• 副本数：未设置时默认 1 个副本。
• 资源限制：未定义时提供保守的 CPU/内存配额。

4.2 required 函数：强制必填参数

对于数据库连接串、、集群域名等关键配置，使用 required 函数可以在渲染阶段强制用户提供值，否则 Chart 安装失败并输出自定义错误信息。语法：

{{ required "A valid .Values.database.url is required!" .Values.database.url }}

required 与 default 的对比：

4.3 条件默认值：基于环境动态选择

单一默认值无法满足多集群需求。通过 if 条件判断结合 eq、hasKey 等函数，可以实现“根据环境变量或 Values 字段动态选择默认值”。

{{- if eq .Values.global.environment "production" }}
replicas: 5
{{- else if eq .Values.global.environment "staging" }}
replicas: 3
{{- else }}
replicas: 1
{{- end }}

更优雅的方式是使用 ternary 函数（Helm 3.7+）：

{{ ternary 5 1 (eq .Values.global.environment "production") }}

条件默认值的常见判断依据：

• 环境标签：production / staging / development
• 集群规模：small / medium / large
• 特性开关：features.monitoring.enabled
• 云厂商：aws / gcp / azure

4.4 多环境默认值策略

当 Chart 需要部署到开发、测试、预发、生产等多个环境时，推荐使用 分层覆盖 策略来管理默认值，避免重复定义。

4.4.1 文件分层策略

在 Chart 包内创建环境专属的 values 文件，通过 -f 参数叠加：

helm install myapp ./mychart \
  -f values.yaml \
  -f values-staging.yaml \
  -f values-production.yaml

文件优先级：后加载的文件覆盖前加载的文件。推荐的文件结构：

4.4.2 全局字段 + 局部覆盖策略

在 values.yaml 中定义 global 字段作为共享默认值，各组件通过 default 函数引用：

# values.yaml
global:
  environment: development
  imageRegistry: docker.io/myrepo
  logLevel: info

service:
  replicas: {{ default 1 (dict "development" 1 "staging" 3 "production" 5).Values.global.environment }}

这种方式将环境差异收敛到 global.environment 一个字段，用户只需修改一个值即可切换整套配置。

4.5 综合策略对比与选型建议