变更门禁系统基础：门禁概念、在CI/CD中的位置、与Federation架构的集成点

1. 变更门禁核心概念

变更门禁（Change Gate）是部署流水线中一道可编程的安全闸门。它在制品从构建环境向生产环境流转的关键节点上，根据预定义的策略自动判定“是否允许当前变更继续前进”。门禁的本质是将人工审批转化为自动化策略执行，从而消除人为延迟与主观判断偏差。

门禁系统在CI/CD中承担以下核心职责：

• 质量护栏：阻止未通过测试覆盖率、安全扫描、性能基线等质量阈值的变更进入下游环境。
• 合规守门员：确保变更满足合规要求（如代码签名、依赖许可、数据分类标签）。
• 风险缓释器：在变更影响范围超出预设风险等级时，自动触发人工审批或回滚流程。
• 审计锚点：记录每一次门禁判定的输入、输出、时间戳和决策依据，供事后追溯。

2. 变更门禁在CI/CD流水线中的位置

门禁通常部署在流水线的环境转换边界上。以下表格展示了典型CI/CD流水线中门禁的部署位置与判定依据：

下图展示了门禁在典型CI/CD流水线中的嵌入位置与数据流向：

3. 门禁系统与Federation架构的集成点

在Federation架构下，多个联邦集群（Region/Zone/Cloud）共享同一个控制平面，但各自拥有独立的计算与存储资源。门禁系统需要与Federation的资源抽象层和策略分发层深度集成，才能实现跨集群的统一变更管控。

以下是门禁系统与Federation架构的四个核心集成点：

1. 联邦策略同步点：门禁策略在Federation控制平面定义，通过策略分发通道同步到所有联邦成员集群。每个成员集群本地缓存策略副本，确保网络分区时仍能执行门禁判定。
2. 跨集群状态查询点：门禁判定需要读取联邦级别的全局状态（如全局金丝雀比例、跨集群流量分配、全局特性开关）。门禁引擎通过Federation API Server查询这些状态。
3. 联邦级阻断/放行点：当门禁判定为“阻断”时，不仅阻止当前集群的变更，还需要通过Federation控制平面通知其他集群暂停相关变更，防止级联故障。
4. 审计日志汇聚点：每个联邦成员集群的门禁判定日志需要汇聚到Federation控制平面的审计中心，形成全局变更审计视图。

下图展示了门禁系统与Federation架构的集成关系：

4. 门禁判定流程与Federation集成示例

以下代码展示了一个简化的门禁判定函数，该函数在Federation环境下查询全局状态并执行策略：

# 伪代码：Federation门禁判定流程
def evaluate_change_gate(change_request, federation_client):
    # 1. 获取本地缓存的策略
    local_policy = get_local_policy_cache(change_request.cluster_id)

    # 2. 如果本地缓存过期，从Federation控制平面拉取最新策略
    if local_policy.is_expired():
        local_policy = federation_client.fetch_policy(change_request.cluster_id)
        update_local_policy_cache(change_request.cluster_id, local_policy)

    # 3. 查询联邦级全局状态（如全局金丝雀比例）
    global_state = federation_client.query_global_state(
        scope="canary_ratio",
        region=change_request.region
    )

    # 4. 执行门禁判定
    gate_result = local_policy.evaluate(
        artifact=change_request.artifact,
        target_env=change_request.target_env,
        global_state=global_state
    )

    # 5. 如果阻断，通知Federation控制平面暂停关联集群的变更
    if gate_result.action == "BLOCK":
        federation_client.notify_block(
            change_id=change_request.change_id,
            reason=gate_result.reason,
            affected_clusters=gate_result.affected_clusters
        )

    # 6. 记录审计日志到Federation审计中心
    federation_client.audit_log(
        change_id=change_request.change_id,
        cluster_id=change_request.cluster_id,
        decision=gate_result.action,
        policy_version=local_policy.version,
        timestamp=now()
    )

    return gate_result