4. 准入接口概念：准入接口的定义、作用、与门禁系统的关系

准入接口是发布门禁系统中连接门禁策略引擎与外部调用方（如 CI/CD 流水线、人工审批平台、自动化测试框架）的核心契约点。它定义了“谁、在什么条件下、可以执行哪个发布动作”的标准化通信协议。

4.1 准入接口的定义

准入接口（Admission Interface）是一组 RESTful API 端点，用于接收发布请求、查询门禁状态、提交审批结果以及触发灰度准入校验。它不直接执行部署，而是作为门禁系统的前置裁决层，在发布动作发生前完成所有约束条件的检查。

4.2 准入接口的作用

准入接口在发布流程中承担三个核心作用：

• 前置拦截：在部署动作执行前，拦截不符合门禁条件的发布请求，避免有缺陷的版本进入生产环境。
• 策略解耦：将门禁策略（如代码扫描阈值、性能基线、审批链）与 CI/CD 工具链解耦，策略变更无需修改流水线脚本。
• 审计凭证：每次接口调用生成不可篡改的审计日志，记录决策时间、决策依据、决策人（或自动化规则），满足合规要求。

4.3 准入接口与门禁系统的关系

门禁系统是发布安全管控的大脑，而准入接口是门禁系统的神经末梢。两者通过以下三层关系协同工作：

1. 调用关系：CI/CD 流水线通过准入接口向门禁系统发起校验请求，门禁系统返回决策结果。
2. 策略映射：门禁系统内部维护策略规则库，准入接口负责将外部请求映射到对应的策略规则上执行。
3. 状态同步：灰度发布过程中，准入接口持续轮询或通过 Webhook 接收门禁系统的状态变更通知，驱动流水线进入下一阶段。

4.4 接口调用流程示例

以下是一个典型的准入接口调用流程，展示门禁系统如何通过接口完成一次发布裁决：

# 1. 流水线发起准入检查
POST /v1/admission/check
Content-Type: application/json
Authorization: Bearer <jwt_>

{
  "releaseId": "REL-2025-001",
  "env": "staging",
  "version": "v2.3.1",
  "trigger": "jenkins-pipeline-42",
  "artifacts": ["app-v2.3.1.tar.gz", "db-migration-v2.3.1.sql"]
}

# 2. 门禁系统返回决策
HTTP/1.1 200 OK
Content-Type: application/json

{
  "decision": "APPROVED",
  "decisionTraceId": "admt-20250321-a1b2c3",
  "checkedRules": [
    {"rule": "code_scan_critical", "status": "PASS"},
    {"rule": "unit_test_coverage", "status": "PASS", "threshold": "80%", "actual": "87%"},
    {"rule": "performance_baseline", "status": "PASS", "p99_latency": "120ms"}
  ],
  "expiresAt": "2025-03-21T14:30:00Z"
}

# 3. 流水线根据决策继续执行或中止
if decision == "APPROVED":
    proceed_with_deployment()
else:
    abort_pipeline(reason)

4.5 接口契约与门禁策略的映射关系

准入接口的输入参数需要与门禁系统的策略规则建立明确的映射关系，确保每个请求都能被正确路由到对应的策略执行器：