2. 核心概念：质量门禁（Quality Gate）的定义、作用与常见场景

2.1 质量门禁的定义

质量门禁（Quality Gate）是软件交付流水线中的一个可编程检查点，它在特定阶段（如构建后、部署前、发布前）自动评估一组预定义的度量指标是否满足阈值。只有通过所有检查的制品才能进入下一阶段，否则流水线被阻断或触发告警。

2.2 质量门禁的作用

2.3 质量门禁的常见场景

质量门禁可部署在软件交付生命周期的多个环节，以下按阶段列出典型场景：

1. 代码提交与合并（CI 阶段）
   • 静态代码分析：圈复杂度 < 15、代码重复率 < 5%
   • 单元测试覆盖率：行覆盖率 ≥ 80%，分支覆盖率 ≥ 70%
   • 安全扫描：无 Critical/High 级别漏洞
2. 构建与制品生成（CI 阶段）
   • 构建成功率：100%
   • 制品大小增量：不超过基线 10%
   • 依赖漏洞：无已知 CVE 且 CVSS ≥ 7.0
3. 测试环境部署与集成测试（CD 阶段）
   • 接口成功率：≥ 99.5%
   • 端到端场景通过率：100%
   • 性能基线：P99 延迟不超过基线 20%
4. 预发布/灰度发布（CD 阶段）
   • 错误率：5xx 响应占比 < 0.1%
   • 黄金指标：延迟、流量、错误、饱和度均在 SLO 范围内
   • 变更影响：关键业务指标（如订单量、登录成功率）无显著下降
5. 生产发布与运营（Release 阶段）
   • 发布窗口：仅允许在指定时间窗口内执行
   • 回滚就绪：确认回滚脚本和数据库迁移回退方案已验证
   • 可观测性就绪：新版本指标已接入监控，告警规则已生效

2.4 质量门禁与 SLI 的关系

质量门禁的输入数据主要来自 SLI（Service Level Indicator）。SLI 是原始度量值，质量门禁是“SLI + 阈值”的决策引擎。两者关系如下：

在 OpenTelemetry 生态中，质量门禁通过 OTel Collector 或自定义 exporter 拉取 SLI 数据，与预定义阈值比对后输出 pass/fail 结果，驱动流水线决策。

2.5 质量门禁的设计原则

• 可观测性驱动：所有门禁指标必须来自可观测性平台（如 OpenTelemetry、Prometheus），确保数据真实可追溯。
• 渐进式严格：早期阶段（如代码提交）门禁较宽松，越靠近生产越严格，避免过度阻塞开发效率。
• 可绕过机制：紧急修复场景下允许管理员绕过门禁，但必须记录审计日志并事后复盘。
• 阈值动态化：基于历史 SLI 数据自动计算基线，避免静态阈值导致误报或漏报。
• 反馈闭环：门禁失败数据应自动生成改进项，关联到对应团队或服务负责人。