4、单元测试基础：什么是Helm单元测试、使用helm unittest插件、安装helm-unittest插件

4.1 什么是Helm单元测试

Helm单元测试是一种在不连接真实Kubernetes集群的情况下，对Chart模板渲染结果进行自动化验证的轻量级方法。它通过定义一组测试用例（通常以YAML格式编写），断言模板渲染后的输出是否符合预期结构、字段值或资源类型。

与集成测试不同，单元测试不涉及实际部署、服务依赖或网络通信，仅关注模板逻辑的正确性。其核心价值在于：

• 快速反馈：毫秒级执行，适合在开发阶段频繁运行。
• 隔离性：不依赖集群环境，可在任何机器上运行。
• 可重复性：相同的输入始终产生相同的测试结果。
• 低门槛：无需配置复杂的测试基础设施。

4.2 Helm单元测试 vs 集成测试

4.3 使用helm unittest插件

helm-unittest 是一个专为Helm Chart设计的第三方单元测试插件。它基于YAML测试文件定义断言，支持对模板输出进行结构匹配、值匹配、正则匹配和文档数量验证。

一个典型的测试文件结构如下：

# tests/deployment_test.yaml
suite: test deployment
templates:
  - templates/deployment.yaml
tests:
  - it: should set replicas to 3
    set:
      replicaCount: 3
    asserts:
      - equal:
          path: spec.replicas
          value: 3
  - it: should have container port 8080
    asserts:
      - equal:
          path: spec.template.spec.containers[0].ports[0].containerPort
          value: 8080

核心概念说明：

• suite：测试套件名称，用于组织一组相关测试。
• templates：指定要测试的模板文件列表。
• tests：测试用例列表，每个用例包含 it 描述、set 输入值和 asserts 断言。
• asserts：断言列表，支持 equal、matchRegex、isEmpty、isNotEmpty、hasDocuments 等类型。

4.4 安装helm-unittest插件

安装 helm-unittest 插件前，请确保已安装Helm客户端（版本 ≥ 3.0.0）。以下是两种安装方式：

方式一：使用Helm插件命令安装（推荐）

# 安装最新版本
helm plugin install https://github.com/helm-unittest/helm-unittest.git

# 验证安装
helm plugin list

# 输出示例：
# NAME           VERSION  DESCRIPTION
# unittest       x.x.x    Unit test for helm charts

方式二：从GitHub Release手动安装

# 1. 下载对应操作系统的二进制包
# 2. 解压到 ~/.local/share/helm/plugins/helm-unittest/
# 3. 确保 helm-unittest 二进制文件在 PATH 中

# 验证安装
helm unittest --version

安装后验证

# 查看帮助信息
helm unittest --help

# 在Chart目录中运行测试（需先创建测试文件）
helm unittest ./mychart

4.5 Helm单元测试执行流程

4.6 快速上手示例

以下是一个完整的单元测试实战流程，包含Chart结构和测试文件：

# Chart目录结构
mychart/
├── Chart.yaml
├── values.yaml
├── templates/
│   └── deployment.yaml
└── tests/
    └── deployment_test.yaml

# values.yaml
replicaCount: 2
image:
  repository: nginx
  tag: latest

# templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ .Release.Name }}-nginx
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
        - name: nginx
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
          ports:
            - containerPort: 80

# tests/deployment_test.yaml
suite: test deployment
templates:
  - templates/deployment.yaml
tests:
  - it: should have correct name
    asserts:
      - equal:
          path: metadata.name
          value: RELEASE-NAME-nginx
  - it: should have 2 replicas
    asserts:
      - equal:
          path: spec.replicas
          value: 2
  - it: should use nginx:latest image
    asserts:
      - matchRegex:
          path: spec.template.spec.containers[0].image
          pattern: nginx:latest

# 执行测试
cd mychart
helm unittest .

# 输出示例
#  PASS  test deployment  tests/deployment_test.yaml
#  PASS  test deployment  tests/deployment_test.yaml
#  PASS  test deployment  tests/deployment_test.yaml
#  --------------------
#  Charts:      1 passed, 1 total
#  Test Suites: 1 passed, 1 total
#  Tests:       3 passed, 3 total
#  Assertions:  3 passed, 3 total