1. 课程导论：质量门禁概念、Jaeger在环境一致性中的角色、课程目标与受众
1.1 质量门禁：从“事后发现”到“事前阻断”
在微服务与云原生架构中，配置漂移（Configuration Drift）是导致环境不一致、故障定位困难的首要原因。传统做法依赖人工巡检或事后告警，但这种方式存在两个致命缺陷：发现滞后（问题已影响用户）和归因困难（多个变更叠加难以追溯）。
质量门禁（Quality Gate）是一种在软件交付生命周期中嵌入的自动化检查机制。它在关键节点（如构建、部署、发布前）执行预定义的验证规则，只有通过所有检查的制品或配置才能进入下一阶段。其核心价值在于：
- 左移验证：将环境一致性检查从运行时前移到部署前。
- 自动化阻断：不符合基线配置的变更自动被拒绝，无需人工干预。
- 可审计追溯：每次门禁检查的结果、时间、触发者均被记录，形成不可篡改的审计链。
关键指标： 实施质量门禁后，配置相关故障的平均发现时间（MTTD）可从小时级缩短至分钟级，平均恢复时间（MTTR）降低 60% 以上。
1.2 Jaeger在环境一致性中的角色
Jaeger 是 CNCF 毕业的分布式追踪系统，通常被用于请求链路分析和性能诊断。但在本课程中，我们赋予它一个全新的角色——配置环境一致性的验证探针。
其核心原理是：通过 Jaeger 的 Span 标签（Tags）和 Baggage（上下文传播）机制，将每个微服务的配置版本、环境标识、依赖组件版本等信息嵌入到追踪数据中。当请求流经多个服务时，这些配置元数据会随链路自动聚合。质量门禁引擎通过分析聚合后的追踪数据，即可判断整个调用链上的配置是否与基线一致。
| 传统角色 | 本课程中的新角色 |
|---|---|
| 分布式请求追踪 | 配置元数据采集与传播 |
| 性能瓶颈定位 | 配置漂移检测与定位 |
| 调用拓扑可视化 | 配置一致性拓扑可视化 |
| 采样与存储 | 门禁检查数据源 |
为什么选择 Jaeger？ 它原生支持 OpenTelemetry 标准，具备跨语言、跨协议的上下文传播能力，且已广泛部署在生产环境中。复用现有追踪基础设施实现配置验证，无需引入额外的 Agent 或 Sidecar。
1.3 课程目标与受众
课程目标
完成本课程后，学员将能够：
- 设计并实现基于 Jaeger 的配置环境一致性验证门禁系统。
- 编写质量门禁规则，覆盖配置版本、环境标签、依赖版本等维度。
- 集成门禁到 CI/CD 流水线（Jenkins、GitLab CI、ArgoCD），实现自动化阻断。
- 构建配置漂移的可观测性仪表盘，实时展示环境一致性状态。
- 制定门禁策略，平衡安全性与交付效率。
目标受众
| 角色 | 收益 | 前置知识 |
|---|---|---|
| SRE / 平台工程师 | 掌握配置一致性自动化验证方法，减少故障 | Kubernetes 基础、CI/CD 概念 |
| 可观测性工程师 | 扩展 Jaeger 应用场景，提升追踪数据价值 | OpenTelemetry、Jaeger 基础 |
| DevOps 工程师 | 在流水线中嵌入质量门禁，提升交付质量 | Jenkins / GitLab CI 使用经验 |
| 微服务架构师 | 设计配置治理方案，保障多环境一致性 | 微服务架构、配置中心原理 |
注意： 本课程不涉及 Jaeger 的基础安装与部署。学员应已具备 Jaeger 或 OpenTelemetry 的基本使用经验。课程重点在于“如何利用 Jaeger 实现门禁”，而非“如何搭建 Jaeger”。