3、质量门禁架构：门禁在CI/CD流水线中的位置、触发条件与SLO台账交互

质量门禁（Quality Gate）是SRE体系在CI/CD流水线中的“硬卡口”。它不是一个独立的服务，而是一组嵌入在流水线阶段的检查规则引擎，通过与SLO台账的实时交互，决定是否阻断发布。理解门禁的架构位置、触发条件以及与台账的数据流，是后续分析误报根因的基础。

3.1 门禁在CI/CD流水线中的位置

质量门禁通常部署在预发布验证阶段与生产灰度阶段之间，以及灰度放量阶段的每个关键百分比节点。其核心原则是：越早发现风险，修复成本越低；越靠近生产，门禁标准越严格。

3.2 门禁触发条件

门禁并非每次流水线执行都触发全部检查。触发条件分为自动触发和条件触发两类，由门禁引擎根据流水线上下文动态决策。

3.2.1 自动触发条件

• 新版本部署请求：任何提交到预发布分支的构建产物，在申请进入生产灰度时自动触发。
• SLO台账变更事件：当SLO台账中的目标值（如SLI阈值、错误预算）发生配置变更时，触发一次全量门禁重评估。
• 定时基线校验：每24小时对当前生产版本的SLO合规状态做一次基线扫描，确保门禁规则与台账一致。

3.2.2 条件触发规则

3.3 门禁与SLO台账的交互流程

门禁引擎与SLO台账之间采用请求-响应模式，通过内部API网关进行同步调用。整个交互流程分为四个步骤，如下图所示。

3.4 交互流程的详细步骤

1. 步骤一：门禁触发 — CI/CD流水线在预发布阶段完成后，向门禁引擎发送部署请求，携带版本号、环境标签、变更类型等元数据。
2. 步骤二：规则匹配与台账查询 — 门禁引擎根据触发条件（自动/条件）匹配对应的门禁规则集，然后向SLO台账服务发起查询请求，获取当前版本的SLI实时数据、错误预算剩余比例以及SLO目标阈值。
3. 步骤三：门禁决策 — 门禁引擎将查询到的SLI数据与SLO阈值进行比对，输出PASS（通过）、FAIL（阻断）或WARN（警告但可继续）三种决策。决策过程会记录详细的比对日志，包括每个SLI的实测值、阈值、偏差量。
4. 步骤四：结果回写与流水线响应 — 门禁决策结果同步回写至SLO台账，台账记录本次门禁事件（时间戳、版本、决策结果、触发规则ID）。同时，门禁引擎将决策结果返回给CI/CD流水线，流水线根据结果决定继续灰度放量或阻断回滚。

3.5 门禁与台账的接口契约

门禁引擎与SLO台账之间的API接口采用RESTful风格，核心接口定义如下：

GET /api/v1/slo/gate-check
  Parameters:
    - service_name: string (必填)
    - version: string (必填)
    - environment: string (必填, 如 "staging", "production-gray-1%")
    - check_type: string (可选, 默认 "full", 可选 "quick")
  Response:
    {
      "gate_id": "uuid",
      "slo_items": [
        {
          "sli_name": "request_success_rate",
          "target": 99.9,
          "current_value": 99.85,
          "error_budget_remaining": 0.35,
          "threshold_type": "hard",
          "status": "FAIL"
        },
        {
          "sli_name": "p99_latency_ms",
          "target": 200,
          "current_value": 185,
          "error_budget_remaining": 0.72,
          "threshold_type": "soft",
          "status": "PASS"
        }
      ],
      "overall_decision": "FAIL",
      "decision_reason": "request_success_rate 低于硬阈值 99.9%"
    }

接口设计遵循幂等性原则：同一版本在相同环境下的多次查询，只要台账数据未更新，返回结果应一致。这避免了因网络重试导致的误报。