4、变更门禁基础概念

变更门禁（Change Gate）是部署流水线中的一道质量闸门。它根据预定义策略自动评估当前变更是否满足准入条件，只有通过门禁的变更才能进入下一阶段（如预发、生产）。门禁的本质是将人工审批转化为自动化数据驱动决策，从而在保障质量的同时提升交付速度。

4.1 什么是变更门禁

变更门禁是一个可编程的决策节点，它订阅来自 CI/CD 流水线的变更事件，结合外部数据源（日志、指标、事件）进行实时评估，最终输出 PASS 或 BLOCK 结果。门禁通常部署在流水线的关键阶段之间，例如：

• 构建后 → 测试前：检查代码规范、依赖漏洞。
• 测试后 → 预发前：检查单元测试覆盖率、性能基线。
• 预发后 → 生产前：检查预发环境错误率、慢请求比例。

4.2 门禁策略的触发条件

门禁策略的触发条件定义了“何时执行评估”。常见的触发模式包括：

• 事件驱动触发：当流水线产生特定事件（如 deployment.created、build.completed）时自动触发门禁评估。
• 定时触发：对于长时间运行的环境（如预发环境），可设置定时门禁（如每 5 分钟检查一次错误率）。
• 手动触发：保留人工干预入口，允许运维人员手动触发门禁重评估。

在 Fluent Bit 集成场景中，最常用的是事件驱动触发。Fluent Bit 作为数据采集层，将日志、指标、事件实时转发到门禁引擎，门禁引擎根据数据流中的异常模式自动阻断或放行变更。

# 门禁触发条件示例（伪代码）
if event.type == "deployment.started" and event.env == "production":
    trigger_gate("production-gate")
    wait_for_evaluation(timeout=120s)
    if gate_result == "BLOCK":
        rollback_deployment()
    else:
        continue_pipeline()

4.3 门禁与 CI/CD 流水线的集成点

门禁与 CI/CD 流水线的集成通常发生在以下三个关键节点：

1. 流水线入口（Pre-Build Gate）：在代码检出后、构建开始前执行。用于检查代码合规性、分支策略、提交信息规范。
2. 测试阶段出口（Post-Test Gate）：在自动化测试完成后执行。用于评估测试覆盖率、测试通过率、性能基线。
3. 部署阶段出口（Pre-Production Gate）：在预发验证完成后、生产发布前执行。用于评估预发环境的可观测性数据（错误率、日志异常、告警事件）。

4.4 门禁数据源：日志 / 指标 / 事件

门禁评估依赖三类核心数据源，Fluent Bit 在其中扮演统一采集与转发的角色：

在 Fluent Bit 的流水线中，这三类数据经过采集 → 解析 → 过滤 → 路由后，被发送到门禁引擎的评估端点。门禁引擎根据预定义策略计算得分，并与阈值比较，最终输出门禁结果。

4.5 门禁策略示例（Fluent Bit 数据源）

以下是一个基于 Fluent Bit 采集的日志和指标数据实现的变更门禁策略示例：

# 门禁策略：预发环境健康检查
gate_name: "pre-production-health-gate"
trigger:
  event: "deployment.pre-production.completed"
  timeout: 120s
rules:
  - name: "error_rate_check"
    data_source: "fluent_bit_logs"
    query: "rate(error_count[5m]) / rate(total_count[5m])"
    threshold: 0.01  # 错误率超过 1% 则阻断
    action: BLOCK
  - name: "p99_latency_check"
    data_source: "fluent_bit_metrics"
    query: "histogram_quantile(0.99, rate(http_request_duration_seconds_bucket[5m]))"
    threshold: 0.5  # P99 延迟超过 500ms 则阻断
    action: BLOCK
  - name: "critical_event_check"
    data_source: "fluent_bit_events"
    query: "count(critical_alerts{severity='critical'})"
    threshold: 0  # 出现任何 Critical 告警则阻断
    action: BLOCK
on_block:
  notify: ["slack:#ops-alerts", "email:oncall@company.com"]
  rollback: true