4. Values参数基础：数据类型、默认值与用户自定义覆盖机制

Values 是 Helm Chart 中实现配置与模板分离的核心机制。理解 Values 的数据类型、默认值设置规则以及用户自定义覆盖的优先级，是进行故障域隔离参数调优的前提。本章将系统梳理这些基础概念，并通过实战案例展示如何利用 Values 机制实现多环境、多故障域的灵活配置。

4.1 Values 支持的数据类型

Helm 的 Values 文件（通常为 values.yaml）使用 YAML 格式定义，支持以下六种核心数据类型。在模板中通过 .Values 对象引用时，Go 模板引擎会自动进行类型推断。

4.2 默认值设置的最佳实践

每个 Chart 的 values.yaml 文件定义了所有可配置参数的默认值。这些默认值应遵循以下原则：

• 完整性：所有模板中引用的 .Values 路径都应在 values.yaml 中有定义，避免模板渲染时报错。
• 安全性：默认值应选择最保守、最安全的配置，例如最小副本数、最低资源限制。
• 可读性：为每个参数添加 YAML 注释，说明用途、可选值和默认行为。
• 层次化：使用嵌套结构组织相关参数，避免扁平化命名。

# values.yaml — 默认值示例
global:
  environment: production
  faultDomain: default

replicaCount: 2

image:
  repository: nginx
  tag: "1.25.3"
  pullPolicy: IfNotPresent

resources:
  requests:
    cpu: "100m"
    memory: "128Mi"
  limits:
    cpu: "500m"
    memory: "512Mi"

# 故障域特定配置（默认空，由用户覆盖）
faultDomainOverrides: {}
  # az-a:
  #   replicaCount: 5
  #   resources:
  #     requests:
  #       cpu: "200m"

4.3 用户自定义覆盖机制

Helm 提供了多层覆盖机制，允许用户在不修改 Chart 源码的前提下，按需调整 Values。覆盖优先级从低到高依次为：

1. Chart 内置默认值（values.yaml）— 优先级最低
2. 父 Chart 的 Values（当 Chart 作为子 Chart 使用时）
3. 用户自定义 Values 文件（通过 -f 或 --values 指定）
4. 命令行 --set 参数 — 优先级最高

在故障域隔离演练中，最常用的覆盖方式是通过 -f 指定环境或故障域专用的 Values 文件：

# 部署到可用区 A
helm install my-app ./my-chart \
  -f values.yaml \
  -f values-az-a.yaml

# 部署到可用区 B
helm install my-app ./my-chart \
  -f values.yaml \
  -f values-az-b.yaml

4.4 Values 合并与覆盖的 SVG 流程

下图展示了 Helm 在渲染模板时，如何将多层 Values 源合并为最终的 .Values 对象：

4.5 故障域隔离中的 Values 设计模式

在故障域隔离演练中，推荐使用 “基础默认值 + 故障域覆盖” 的设计模式。这种模式通过字典嵌套实现差异化配置，同时保持模板的通用性。

# values.yaml — 基础默认值
global:
  faultDomain: ""

service:
  port: 80

# values-az-a.yaml — 可用区 A 覆盖
global:
  faultDomain: "az-a"
replicaCount: 5
resources:
  requests:
    cpu: "200m"
    memory: "256Mi"

# values-az-b.yaml — 可用区 B 覆盖
global:
  faultDomain: "az-b"
replicaCount: 3
resources:
  requests:
    cpu: "150m"
    memory: "192Mi"

在模板中，通过 .Values.global.faultDomain 判断当前部署的目标故障域，并据此选择配置：

{{- if eq .Values.global.faultDomain "az-a" }}
  {{- /* 使用 az-a 专属配置 */}}
  replicas: {{ .Values.replicaCount }}
{{- else if eq .Values.global.faultDomain "az-b" }}
  {{- /* 使用 az-b 专属配置 */}}
  replicas: {{ .Values.replicaCount }}
{{- else }}
  {{- /* 使用默认配置 */}}
  replicas: {{ .Values.replicaCount }}
{{- end }}

4.6 数据类型与覆盖的常见陷阱

4.7 实战：为故障域隔离设计 Values 结构

以下是一个面向三可用区部署的 Values 结构设计，展示了如何通过数据类型组合实现灵活的故障域隔离：

# values.yaml — 三可用区故障域隔离设计
global:
  environment: production
  faultDomains:
    - az-a
    - az-b
    - az-c

# 每个故障域的独立配置（dict 嵌套）
domainConfig:
  az-a:
    replicaCount: 5
    nodeSelector:
      topology.kubernetes.io/zone: az-a
    resources:
      requests:
        cpu: "200m"
        memory: "256Mi"
  az-b:
    replicaCount: 3
    nodeSelector:
      topology.kubernetes.io/zone: az-b
    resources:
      requests:
        cpu: "150m"
        memory: "192Mi"
  az-c:
    replicaCount: 4
    nodeSelector:
      topology.kubernetes.io/zone: az-c
    resources:
      requests:
        cpu: "180m"
        memory: "224Mi"

# 全局默认值（当 domainConfig 中未指定时使用）
defaultReplicaCount: 2
defaultResources:
  requests:
    cpu: "100m"
    memory: "128Mi"

在模板中，通过 index 函数按故障域名称动态选择配置：

{{- $domain := .Values.global.faultDomain | default "az-a" }}
{{- $config := index .Values.domainConfig $domain }}
replicas: {{ $config.replicaCount | default .Values.defaultReplicaCount }}
resources:
  requests:
    cpu: {{ $config.resources.requests.cpu | default .Values.defaultResources.requests.cpu }}
    memory: {{ $config.resources.requests.memory | default .Values.defaultResources.requests.memory }}