📚 课程目录第2章 Helm Chart基础回顾

2. Helm基础回顾：Chart结构、模板语法、Values文件、依赖管理

在搭建自动化测试驱动的发布质量门禁之前，必须牢固掌握Helm的核心概念。Helm是Kubernetes的包管理工具，它将一组Kubernetes资源描述文件打包为一个Chart。本章将系统回顾Chart的标准目录结构、Go模板语法、Values值文件以及依赖管理机制，为后续编写测试用例和门禁规则打下基础。

2.1 Chart标准目录结构

一个标准的Helm Chart遵循固定的目录布局。理解每个文件和目录的作用，是编写可维护Chart的第一步。

路径 / 文件	必需	说明
`Chart.yaml`	是	Chart的元数据文件，包含名称、版本、描述、API版本等。
`values.yaml`	是	默认配置值文件，用户可通过此文件覆盖模板中的变量。
`templates/`	是	存放Kubernetes资源模板文件（如Deployment、Service、Ingress等），使用Go模板语法。
`charts/`	否	存放子Chart（依赖包），由`helm dependency`命令管理。
`crds/`	否	存放自定义资源定义（CRD），Helm会在安装时优先应用此目录下的YAML。
`templates/NOTES.txt`	否	安装成功后向用户显示的帮助信息模板。
`templates/_helpers.tpl`	否	存放可复用的模板片段（命名模板），通过`include`或`template`调用。

最佳实践：始终将可复用的逻辑（如标签生成、名称截断）放在 _helpers.tpl 中，保持主模板文件简洁，便于自动化测试对模板输出进行断言。

2.2 模板语法核心要素

Helm使用Go模板引擎（text/template）结合Sprig函数库来渲染Kubernetes资源。以下是门禁测试中最常遇到的语法元素。

2.2.1 数据注入与内置对象

.Values：从values.yaml或用户提供的值文件中读取配置。
.Release：包含Release名称、命名空间、版本等信息。
.Chart：包含Chart.yaml中的元数据。
.Files：用于访问Chart包内的非模板文件。

2.2.2 常用控制结构与函数

语法 / 函数	用途	测试关注点
`{{ .Values.replicaCount }}`	变量插值	值是否被正确渲染到YAML字段
`{{- if .Values.ingress.enabled -}}`	条件判断	条件分支是否按预期生成/隐藏资源
`{{- range .Values.ports -}}`	循环遍历列表	列表长度、字段映射是否正确
`{{ .Values.name \| default "app" }}`	管道与默认值	缺失值时是否使用默认值
`{{ .Values.image.tag \| quote }}`	字符串引号处理	数字型tag是否被正确引号包裹
`{{ include "mychart.labels" . }}`	引入命名模板	命名模板输出是否符合预期

  自动化测试切入点：门禁测试应覆盖上述每种语法场景，特别是if条件分支的真/假两种状态，以及range循环的空列表边界情况。

2.3 Values文件层级与作用域

Values文件是Chart的配置接口。Helm支持多层级值文件合并，理解其优先级对测试至关重要。

# values.yaml (默认值)
replicaCount: 1
image:
  repository: nginx
  tag: latest
service:
  type: ClusterIP
  port: 80

# production-values.yaml (生产覆盖)
replicaCount: 3
image:
  tag: 1.25.0
service:
  type: LoadBalancer

值合并优先级（从低到高）：

values.yaml（Chart内置默认值）
父Chart的values.yaml（当作为子Chart时）
用户通过 -f 指定的值文件（按顺序叠加）
用户通过 --set 指定的单个参数

常见陷阱：当使用 --set 设置嵌套字段时（如 --set image.tag=v2），Helm会覆盖整个 image 对象，而非仅合并 tag 字段。自动化测试应验证这种“对象替换”行为是否导致其他字段丢失。

2.4 依赖管理机制

大型应用通常拆分为多个子Chart。Helm通过 Chart.yaml 中的 dependencies 字段管理依赖。

# Chart.yaml
dependencies:
  - name: postgresql
    version: "12.1.6"
    repository: "https://charts.bitnami.com/bitnami"
    condition: postgresql.enabled   # 条件控制是否安装
    alias: db                       # 别名，避免命名冲突
    tags:
      - database

2.4.1 依赖管理命令

命令	作用	测试场景
`helm dependency update`	根据 `Chart.yaml` 下载依赖到 `charts/` 目录，并生成 `Chart.lock`	验证锁文件版本是否与声明一致
`helm dependency build`	基于 `Chart.lock` 重建依赖，确保可复现	CI中应使用 `build` 而非 `update` 以保证确定性
`helm dependency list`	列出当前依赖状态	检查依赖是否缺失或版本错误

2.4.2 子Chart的值传递

父Chart通过 values.yaml 中与子Chart同名的键传递值：

# 父Chart的 values.yaml
postgresql:
  enabled: true
  postgresqlDatabase: myapp
  postgresqlPassword: secret123

子Chart内部通过 .Values 读取这些值。全局值可通过 .Values.global 在所有Chart间共享。

2.5 模板渲染与调试

在编写自动化测试之前，必须掌握手动渲染模板的方法，以便快速验证模板逻辑。

# 渲染模板到终端（不安装）
helm template my-release ./mychart

# 使用自定义值文件渲染
helm template my-release ./mychart -f custom-values.yaml

# 调试模式：显示模板名称和渲染位置
helm template my-release ./mychart --debug

# 仅渲染特定模板文件
helm template my-release ./mychart -s templates/deployment.yaml

测试技巧：在CI流水线中，使用 helm template 结合 yq 或 kubectl diff 对渲染结果进行结构化断言，是搭建质量门禁的第一步。

2.6 本章小结

Chart结构是Helm的骨架，Chart.yaml、values.yaml、templates/ 是三个必选组件。
模板语法以Go模板为基础，结合Sprig函数，支持条件、循环、管道和命名模板。
Values文件支持多层级合并，优先级从 values.yaml 到 --set 递增，且嵌套对象为整体覆盖。
依赖管理通过 dependencies 字段声明，使用 helm dependency build 确保可复现构建。
调试命令helm template 是自动化测试的核心工具，用于获取渲染后的YAML进行断言。