3、质量门禁基础概念

3.1 质量门禁定义

质量门禁（Quality Gate）是 CI/CD 流水线中预设的自动化检查点，用于在软件交付的特定阶段评估制品或代码是否满足预定义的质量标准。门禁的本质是将“事后发现”转变为“事中阻断”，确保只有符合质量要求的变更才能进入下一环节。

一个完整的质量门禁包含三个要素：

• 度量指标（SLI）： 如代码覆盖率、构建成功率、安全漏洞数、性能响应时间等。
• 阈值规则（SLO）： 如“单元测试覆盖率 ≥ 80%”、“高危漏洞 = 0”。
• 判定动作： 通过（Pass）、阻塞（Block）、警告（Warn）、记录（Log）。

3.2 门禁类型

根据门禁触发后的行为差异，质量门禁分为三种类型：

3.3 门禁在流水线中的位置

质量门禁通常部署在流水线的四个关键阶段，每个阶段的门禁类型和关注点不同：

1. 提交阶段（Commit Stage）： 代码编译、单元测试、静态代码分析。此处以阻塞型门禁为主，确保基础质量。
2. 集成阶段（Integration Stage）： 集成测试、API 契约测试、安全扫描。此处混合使用阻塞型和警告型门禁。
3. 预发布阶段（Staging Stage）： 性能测试、端到端测试、合规检查。此处以警告型和记录型门禁为主。
4. 生产发布阶段（Production Stage）： 灰度验证、金丝雀发布、SLO 校验。此处使用阻塞型门禁确保发布安全。

3.4 门禁配置示例

以下是一个典型的多阶段门禁配置 YAML 示例，展示如何在流水线中定义不同类型的门禁：

quality_gates:
  - stage: "commit"
    gates:
      - name: "编译检查"
        type: blocking
        metric: "build_success"
        threshold: true
      - name: "单元测试覆盖率"
        type: blocking
        metric: "coverage"
        threshold: ">= 80%"
      - name: "代码规范检查"
        type: warning
        metric: "lint_errors"
        threshold: "<= 5"

  - stage: "integration"
    gates:
      - name: "高危漏洞扫描"
        type: blocking
        metric: "critical_vulnerabilities"
        threshold: 0
      - name: "API 兼容性"
        type: warning
        metric: "breaking_changes"
        threshold: 0

  - stage: "staging"
    gates:
      - name: "P95 响应时间"
        type: warning
        metric: "p95_latency_ms"
        threshold: "<= 500"
      - name: "构建耗时趋势"
        type: record
        metric: "build_duration_sec"
        threshold: null

  - stage: "production"
    gates:
      - name: "金丝雀错误率"
        type: blocking
        metric: "error_rate"
        threshold: "<= 0.1%"