2. Release Gate 概念：定义、作用与类型

Release Gate（发布门禁）是 CI/CD 流水线中用于控制软件版本能否从一个阶段进入下一个阶段的质量关卡。它通过预设的规则或人工审批，在关键节点对制品进行验证，只有满足所有条件的版本才能继续前进，否则将被阻断或回滚。

2.1 Release Gate 定义

Release Gate 本质上是一个布尔条件表达式：当所有关联的检查项（指标、测试结果、审批状态）都通过时，门禁打开（PASS）；任意一项失败，门禁关闭（FAIL）。

在灰度发布场景中，Release Gate 通常部署在以下关键位置：

• 预发环境准入：从构建阶段进入预发/灰度环境前
• 灰度批次间：从 5% 灰度扩至 10%、20% 等批次切换时
• 全量发布前：从灰度环境进入生产全量环境前

2.2 门禁在 CI/CD 流水线中的作用

Release Gate 在流水线中承担质量守门员的角色，其核心价值体现在以下四个维度：

2.3 门禁类型

根据判定方式的不同，Release Gate 可分为三大类：人工门禁、自动门禁和指标门禁。下表对比了它们的核心差异：

2.3.1 人工门禁

由指定角色（如 Tech Lead、QA Manager、变更经理）在流水线中手动点击“批准”或“拒绝”。适用于需要业务判断或合规签字的场景。常见实现方式包括：

• GitLab/GitHub 的 Merge Request Approval
• Spinnaker 的 Manual Judgment 阶段
• Jenkins Pipeline 的 input 步骤

2.3.2 自动门禁

基于预定义的自动化检查结果自动判定。检查项通常包括：

• 构建状态：编译是否成功、制品是否生成
• 测试结果：单元测试通过率 ≥ 95%、集成测试零失败
• 安全扫描：无高危/严重漏洞、许可证合规
• 代码质量：SonarQube 质量门禁通过、代码覆盖率 ≥ 80%

2.3.3 指标门禁

这是灰度发布中最核心的门禁类型。它通过实时监控指标与预设阈值的比较，自动判断是否允许继续发布。典型指标包括：

• 错误率：HTTP 5xx 比例、业务异常率
• 延迟：P50/P95/P99 响应时间
• 资源使用：CPU 使用率、内存占用、GC 频率
• 业务指标：下单成功率、支付转化率、DAU 波动

以下 SVG 图展示了三种门禁类型在灰度发布流水线中的协作关系：

2.4 门禁配置示例（Spinnaker Pipeline）

以下是一个使用 Spinnaker 配置指标门禁的 YAML 示例，展示如何将 Prometheus 指标作为门禁判定依据：

# Spinnaker Pipeline - 灰度发布门禁配置
apiVersion: spinnaker.io/v1
kind: Pipeline
metadata:
  name: canary-deploy
spec:
  stages:
    - name: "Canary 5% Deploy"
      type: deploy
      account: kubernetes
      clusters:
        - name: myapp-canary
          capacity:
            desired: 5%
    
    - name: "指标门禁 - 5% 验证"
      type: evaluateVariables
      variables:
        - name: errorRate
          expression: "${#prometheus('rate(http_requests_total{status=~"5.."}[5m])')}"
        - name: p99Latency
          expression: "${#prometheus('histogram_quantile(0.99, rate(http_request_duration_seconds_bucket[5m]))')}"
      failPipeline: true
      failOnFailedExpression: true
      condition: |
        errorRate < 0.01 AND p99Latency < 2.0
    
    - name: "Canary 10% Deploy"
      type: deploy
      account: kubernetes
      clusters:
        - name: myapp-canary
          capacity:
            desired: 10%

2.5 门禁设计最佳实践

1. 分层设置：不同阶段使用不同类型的门禁，人工门禁放在变更审批环节，指标门禁放在灰度放量环节。
2. 阈值渐进：灰度批次越靠后，门禁阈值越严格。例如 5% 批次允许 P99 延迟 < 2s，50% 批次要求 < 1s。
3. 超时与降级：为指标门禁设置超时时间（如 5 分钟），超时后自动降级为“警告”而非“阻断”，避免因监控系统故障阻塞发布。
4. 可观测性：所有门禁判定结果必须记录到审计日志，并支持通过 Dashboard 实时查看门禁状态。
5. 灰度回滚联动：当指标门禁连续失败 N 次时，自动触发回滚操作，将流量切回旧版本。