3. Helm Chart 基础回顾：Chart 结构、Values 文件、模板渲染、Release 管理

在深入 DNS 故障场景的架构适配之前，必须牢固掌握 Helm 的核心基础。Helm 是 Kubernetes 的包管理工具，它将应用定义、配置和部署逻辑封装为 Chart。本节将系统回顾 Chart 的目录结构、Values 文件的参数化机制、Go 模板渲染引擎的工作原理，以及 Release 的生命周期管理。

3.1 Chart 标准目录结构

一个标准的 Helm Chart 遵循固定的目录布局，每个文件和文件夹都有明确的职责。理解这一结构是编写可维护 Chart 的前提。

3.2 Values 文件与参数化

Values 文件是 Helm 实现配置与代码分离的核心机制。通过 values.yaml 定义默认值，用户可以在部署时通过 -f custom-values.yaml 或 --set key=value 进行覆盖。

Values 支持嵌套结构、列表和类型约束。以下是一个典型示例：

# values.yaml
replicaCount: 3

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

service:
  type: ClusterIP
  port: 80

resources:
  limits:
    cpu: 500m
    memory: 512Mi
  requests:
    cpu: 250m
    memory: 256Mi

dnsConfig:
  nameservers:
    - 8.8.8.8
    - 1.1.1.1
  searches:
    - svc.cluster.local
    - default.svc.cluster.local

3.3 模板渲染引擎

Helm 使用 Go 的 text/template 引擎，并扩展了 sprig 函数库。模板文件位于 templates/ 目录，以 .yaml 或 .tpl 结尾。渲染过程将 Values 对象注入模板，生成最终的 Kubernetes 资源清单。

核心语法包括：

• 变量引用：{{ .Values.replicaCount }} —— 点号 . 代表根作用域。
• 流程控制：{{- if .Values.service.enabled }} ... {{- end }} —— 支持条件判断、循环 range。
• 命名模板：在 _helpers.tpl 中定义 {{- define "myapp.labels" -}} ... {{- end }}，在模板中通过 {{ include "myapp.labels" . }} 调用。
• 管道与函数：{{ .Values.image.tag | default "latest" | quote }} —— 支持链式处理。

以下是一个 Deployment 模板的简化示例：

# templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "myapp.fullname" . }}
  labels:
    {{- include "myapp.labels" . | nindent 4 }}
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      {{- include "myapp.selectorLabels" . | nindent 6 }}
  template:
    metadata:
      labels:
        {{- include "myapp.selectorLabels" . | nindent 8 }}
    spec:
      {{- with .Values.dnsConfig }}
      dnsConfig:
        nameservers:
          {{- toYaml .nameservers | nindent 10 }}
        searches:
          {{- toYaml .searches | nindent 10 }}
      {{- end }}
      containers:
        - name: {{ .Chart.Name }}
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
          ports:
            - containerPort: {{ .Values.service.port }}

3.4 Release 管理

Release 是 Helm Chart 的一次部署实例。每次 helm install 或 helm upgrade 都会创建一个新的 Release 版本，并记录在集群的 Secret 中。Release 管理是回滚、升级和故障恢复的基础。

3.5 Chart 渲染与 Release 生命周期流程图

下图展示了从 Chart 源文件到最终 Release 的完整渲染与部署流程，重点标注了 Values 注入和模板渲染的关键步骤。

3.6 模板渲染与 Values 合并机制

为了进一步理解 Values 的优先级和合并规则，下图展示了 Helm 在渲染前如何合并多个 Values 来源。