4、编写第一个Helm Test：创建test Pod、定义test容器、运行helm test命令

Helm Test 是 Chart 开发者用来验证 Release 在目标集群中是否按预期工作的内置机制。它通过在 Chart 的 templates/ 目录中定义特殊的 Pod 资源（带有 helm.sh/hook: test 注解），并在安装或升级后通过 helm test 命令触发执行。本节将引导你从零编写并运行第一个 Helm Test。

4.1 Helm Test 的核心机制

Helm Test 本质上是一个 Kubernetes Pod，它运行一个容器，执行验证逻辑（如 HTTP 请求、数据库查询、文件存在性检查），并根据容器退出码判断测试是否通过：

4.2 创建第一个 Test Pod

在 Chart 的 templates/ 目录下创建一个名为 test-connection.yaml 的文件。这个 Pod 将测试我们之前部署的 Web 应用是否能够正常响应 HTTP 请求。

apiVersion: v1
kind: Pod
metadata:
  name: "{{ include "myapp.fullname" . }}-test-connection"
  labels:
    {{- include "myapp.labels" . | nindent 4 }}
  annotations:
    "helm.sh/hook": test
spec:
  containers:
    - name: wget
      image: busybox:1.36
      command: ['wget']
      args: ['{{ include "myapp.fullname" . }}:{{ .Values.service.port }}']
  restartPolicy: Never

4.3 定义 Test 容器的最佳实践

Test 容器是测试逻辑的执行者。选择正确的镜像和命令直接影响测试的可靠性和可维护性。

4.4 运行 helm test 命令

在 Chart 目录下，确保已经执行过 helm install 或 helm upgrade 使 Release 处于部署状态。然后运行以下命令：

# 基本用法：测试指定 Release
helm test my-release

# 输出详细日志
helm test my-release --logs

# 设置超时时间（单位：秒）
helm test my-release --timeout 60s

# 测试完成后自动清理 Pod
helm test my-release --cleanup

执行 helm test my-release --logs 后，你将看到类似如下的输出：

NAME: my-release
LAST DEPLOYED: Mon Jan 15 10:30:00 2024
NAMESPACE: default
STATUS: deployed

TEST SUITE:     myapp-test-connection
Last Started:   Mon Jan 15 10:30:05 2024
Last Completed: Mon Jan 15 10:30:07 2024
Phase:          Succeeded
Pod Output:
Connecting to myapp-test-connection:80 (10.96.1.5:80)
saving to '/dev/null'
/var/...  100% |*******************************|  1024  0:00:00 ETA

4.5 Helm Test 执行流程（SVG）

下图展示了从定义 Test Pod 到运行 helm test 命令的完整执行流程：

4.6 多 Test Pod 与并行测试

一个 Chart 可以包含多个 Test Pod，它们会并行执行。这在需要同时验证多个组件（如 Web 服务、数据库、缓存）时非常有用。

# 创建第二个 Test Pod：test-db-connection.yaml
apiVersion: v1
kind: Pod
metadata:
  name: "{{ include "myapp.fullname" . }}-test-db"
  annotations:
    "helm.sh/hook": test
spec:
  containers:
    - name: db-test
      image: postgres:15-alpine
      command: ['pg_isready']
      args: ['-h', '{{ .Release.Name }}-postgresql', '-p', '5432']
  restartPolicy: Never

运行 helm test my-release --logs 后，两个 Test Pod 的日志会依次输出：

TEST SUITE:     myapp-test-connection
Phase:          Succeeded
Pod Output: ...
TEST SUITE:     myapp-test-db
Phase:          Succeeded
Pod Output: /var/run/postgresql:5432 - accepting connections

4.7 测试结果解读与故障排查

当测试失败时，Helm 会输出错误信息。以下是一些常见失败场景及解决方法：