4. 校准测试目标：确保 Deployment 版本与预期一致、避免配置漂移

在集群升级场景中，版本漂移是指 Deployment 的实际运行版本与预期版本（即升级目标版本）之间出现不一致的现象。这种不一致可能源于升级过程中的中断、回滚残留、控制器竞争或人为误操作。校准测试的核心目标就是通过系统化的验证手段，确保每个 Deployment 的版本号、镜像摘要、标签选择器与升级计划完全对齐，从而消除配置漂移风险。

4.1 版本漂移的典型成因

理解漂移的成因有助于设计针对性的校准测试用例。下表总结了集群升级过程中最常见的四种漂移场景：

4.2 校准测试的验证维度

校准测试需要覆盖以下四个关键维度，每个维度对应一组具体的校验指标：

1. 版本标识校验：检查 Deployment 的 metadata.labels['app.kubernetes.io/version'] 或自定义版本标签是否等于目标版本号。
2. 镜像一致性校验：检查 spec.template.spec.containers[*].image 是否包含预期的镜像仓库、名称和摘要（SHA256），避免标签漂移。
3. 选择器与标签对齐校验：确保 spec.selector.matchLabels 与 spec.template.metadata.labels 完全匹配，防止 Pod 归属混乱。
4. 副本数与更新策略校验：确认 spec.replicas、spec.strategy 与基线配置一致，避免升级策略被篡改。

4.3 校准测试流程与断言

以下是一个标准化的校准测试流程，适用于自动化测试框架（如 Ginkgo + Kubectl 或 client-go）：

// 伪代码：校准测试核心逻辑
func VerifyDeploymentVersion(targetNs, deployName, expectedVersion string) error {
    deploy, err := clientset.AppsV1().Deployments(targetNs).Get(ctx, deployName, metav1.GetOptions{})
    if err != nil {
        return fmt.Errorf("获取 Deployment 失败: %w", err)
    }

    // 断言 1：版本标签
    actualVersion := deploy.Labels["app.kubernetes.io/version"]
    if actualVersion != expectedVersion {
        return fmt.Errorf("版本漂移: 期望 %s, 实际 %s", expectedVersion, actualVersion)
    }

    // 断言 2：镜像摘要
    for _, c := range deploy.Spec.Template.Spec.Containers {
        if !strings.HasPrefix(c.Image, "registry.example.com/myapp@sha256:") {
            return fmt.Errorf("镜像未使用摘要引用: %s", c.Image)
        }
    }

    // 断言 3：选择器与标签一致性
    if !reflect.DeepEqual(deploy.Spec.Selector.MatchLabels, deploy.Spec.Template.Labels) {
        return fmt.Errorf("选择器与模板标签不匹配")
    }

    // 断言 4：副本数
    if *deploy.Spec.Replicas != 3 {
        return fmt.Errorf("副本数漂移: 期望 3, 实际 %d", *deploy.Spec.Replicas)
    }

    return nil
}

4.4 校准测试的通过/失败判定标准

校准测试的结果判定应遵循“零容忍”原则——任何维度上的不一致都判定为失败。下表列出了具体的判定阈值：

4.5 校准测试的自动化集成建议

• 触发时机：在集群升级完成后、流量切换前执行校准测试，作为升级流程的“门禁”步骤。
• 失败处理：校准测试失败时，应自动阻断后续流量切换，并触发告警通知 SRE 介入。
• 报告输出：生成包含每个 Deployment 的预期版本、实际版本、漂移字段和测试结论的结构化报告。

4.6 校准测试的验证闭环

下图展示了校准测试在集群升级流程中的位置及其与版本基线、配置漂移检测的关系：

4.7 校准测试报告示例

校准测试完成后，应输出结构化的测试报告。以下是一个简化的报告模板：

校准测试报告 - 集群: prod-us-east-1
升级目标版本: v2.3.1
测试时间: 2025-03-20T14:30:00Z

| Namespace | Deployment    | 预期版本 | 实际版本 | 镜像摘要一致 | 选择器一致 | 副本数 | 结果   |
|-----------|---------------|----------|----------|--------------|------------|--------|--------|
| default   | frontend      | v2.3.1   | v2.3.1   | ✅           | ✅         | 3      | PASS   |
| default   | backend-api   | v2.3.1   | v2.3.0   | ❌           | ✅         | 3      | FAIL   |
| default   | cache-service | v2.3.1   | v2.3.1   | ✅           | ❌         | 2      | FAIL   |

总结: 3 个 Deployment 中 1 个通过, 2 个失败。
失败详情:
  - backend-api: 版本漂移 (v2.3.0), 镜像摘要不匹配
  - cache-service: 选择器与模板标签不一致, 副本数漂移 (期望 3, 实际 2)