3. Helm Chart 基础：Chart 结构解析与模板引擎语法

在 Kubernetes 压测与容量基线校准场景中，Helm Chart 是标准化发布的核心载体。理解 Chart 的内部结构以及模板引擎的工作方式，是编写可复用、可参数化压测配置的前提。本节将深入解析 Chart 的三大核心文件，并系统讲解模板引擎的关键语法。

3.1 Chart 目录结构与核心文件

一个标准的 Helm Chart 遵循固定的目录布局。以下是一个用于压测场景的 Chart 结构示例：

loadtest-chart/
├── Chart.yaml          # Chart 元数据定义
├── values.yaml         # 默认配置值
├── charts/             # 子 Chart 依赖（可选）
├── templates/          # Kubernetes 资源模板
│   ├── _helpers.tpl    # 模板辅助函数
│   ├── deployment.yaml
│   ├── service.yaml
│   ├── configmap.yaml
│   ├── hpa.yaml        # 水平自动扩缩容
│   └── tests/
│       └── test-connection.yaml
└── .helmignore         # 打包忽略规则

3.2 Chart.yaml：Chart 的身份证

Chart.yaml 是每个 Chart 的必需文件，定义了 Chart 的元数据。Helm 通过该文件识别 Chart 的名称、版本、依赖关系等信息。

# Chart.yaml 示例
apiVersion: v2
name: loadtest-baseline
description: A Helm chart for Kubernetes load testing baseline calibration
type: application
version: 1.0.0
appVersion: "2.5.1"
dependencies:
  - name: prometheus
    version: "15.0.0"
    repository: "https://prometheus-community.github.io/helm-charts"
    condition: prometheus.enabled

3.3 values.yaml：配置的单一真相源

values.yaml 定义了 Chart 的所有可配置参数及其默认值。在压测场景中，它是容量基线校准的“参数清单”。

# values.yaml 示例（压测场景）
replicaCount: 3

image:
  repository: nginx
  tag: stable
  pullPolicy: IfNotPresent

loadtest:
  concurrency: 50          # 并发数
  duration: "300s"         # 压测持续时间
  targetQPS: 1000          # 目标每秒请求数
  rampUpTime: "30s"        # 预热时间

resources:
  limits:
    cpu: "2"
    memory: "4Gi"
  requests:
    cpu: "500m"
    memory: "1Gi"

autoscaling:
  enabled: true
  minReplicas: 3
  maxReplicas: 20
  targetCPUUtilizationPercentage: 80

service:
  type: ClusterIP
  port: 80

3.4 templates/：资源模板的核心

templates/ 目录包含 Go 模板文件，Helm 会将这些模板与 values.yaml 合并渲染为最终的 Kubernetes 资源清单。模板文件使用 .yaml 或 .tpl 扩展名。

以下是一个 Deployment 模板示例，展示了如何引用 values.yaml 中的值：

{{- /* templates/deployment.yaml */ -}}
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "loadtest-chart.fullname" . }}
  labels:
    app: {{ .Values.image.repository }}
    chart: {{ .Chart.Name }}-{{ .Chart.Version }}
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      app: {{ .Values.image.repository }}
  template:
    metadata:
      labels:
        app: {{ .Values.image.repository }}
    spec:
      containers:
        - name: {{ .Chart.Name }}
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
          env:
            - name: CONCURRENCY
              value: "{{ .Values.loadtest.concurrency }}"
            - name: DURATION
              value: "{{ .Values.loadtest.duration }}"
          resources:
            {{- toYaml .Values.resources | nindent 12 }}

3.5 模板引擎语法详解

Helm 使用 Go 模板引擎，并集成了 Sprig 函数库（超过 70 个模板函数）。掌握以下核心语法是编写复杂压测 Chart 的基础。

3.5.1 数据注入与内置对象

3.5.2 流程控制：条件与循环

流程控制是模板动态化的关键，用于根据条件生成不同的资源或配置。

{{- /* 条件判断：if/else */ -}}
{{- if .Values.autoscaling.enabled }}
apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
  name: {{ include "loadtest-chart.fullname" . }}
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: {{ include "loadtest-chart.fullname" . }}
  minReplicas: {{ .Values.autoscaling.minReplicas }}
  maxReplicas: {{ .Values.autoscaling.maxReplicas }}
  metrics:
    - type: Resource
      resource:
        name: cpu
        target:
          type: Utilization
          averageUtilization: {{ .Values.autoscaling.targetCPUUtilizationPercentage }}
{{- end }}

{{- /* 循环：range 遍历列表 */ -}}
{{- range .Values.loadtest.targets }}
- name: {{ .name }}
  url: {{ .url }}
  method: {{ .method | default "GET" }}
{{- end }}

3.5.3 Sprig 函数库：数据处理利器

Sprig 提供了丰富的字符串、数学、列表、字典操作函数。在压测场景中，以下函数尤为常用：

{{- /* Sprig 函数组合示例 */ -}}
{{- $defaultDuration := "120s" }}
{{- $duration := .Values.loadtest.duration | default $defaultDuration }}
{{- $upperDuration := $duration | upper }}
duration: {{ $upperDuration | quote }}

{{- /* 使用 until 生成压测节点名称 */ -}}
{{- range $i := until (int .Values.replicaCount) }}
- name: "loadgen-{{ $i }}"
  replicas: 1
{{- end }}

3.5.4 管道与作用域

Helm 模板支持 Unix 风格的管道（|），将前一个命令的输出作为后一个命令的输入。作用域（with）用于限定上下文，减少重复引用。

{{- /* 管道示例：链式处理 */ -}}
{{- .Values.loadtest.targetQPS | int | add 100 | quote }}

{{- /* with 作用域：简化深层嵌套引用 */ -}}
{{- with .Values.loadtest }}
concurrency: {{ .concurrency }}
duration: {{ .duration }}
targetQPS: {{ .targetQPS }}
{{- end }}

3.6 Helm Chart 模板渲染流程

理解 Helm 如何将模板与值合并为最终资源清单，有助于调试和优化压测配置。

3.7 压测场景中的模板最佳实践

1. 使用 _helpers.tpl 定义命名规范：将资源名称、标签、选择器的生成逻辑集中管理，确保一致性。
2. 利用 required 函数强制校验：对压测关键参数（如 targetQPS）使用 {{ required "targetQPS is required" .Values.loadtest.targetQPS }}，避免遗漏。
3. 使用 include 复用模板片段：将重复的 Pod 模板、环境变量定义抽取为命名模板，通过 {{ include "templateName" . }} 引用。
4. 通过 --set 覆盖压测参数：在 CI/CD 流水线中，使用 helm upgrade --install --set loadtest.concurrency=100 动态调整压测负载。
5. 使用 helm lint 和 helm template 验证：在提交 Chart 前，运行 helm lint 检查语法，helm template 预览渲染结果。

3.8 本章小结