3. 发布工程自助门户概述
发布工程自助门户是蓝绿发布流程中面向用户的前端交互层，它将底层基础设施的复杂操作抽象为可配置、可审计、可回滚的标准化动作。本节从功能定位、用户角色和与基础设施的关系三个维度展开。
3.1 门户的功能定位
自助门户不是简单的“点击部署”按钮，而是承载发布策略、流量规则、验证逻辑和权限管控的编排层。其核心能力包括：
- 发布模板管理：预定义蓝绿、金丝雀、滚动等发布策略模板，用户只需填写环境参数和版本号。
- 流量切换控制：支持权重调整、全量切换、灰度暂停/继续，并记录每次切换的审计日志。
- 验证任务编排：在流量切换前后自动触发健康检查、冒烟测试、业务拨测，结果实时回显。
- 回滚与应急：一键回退到上一个稳定版本，保留历史发布记录和流量快照。
- 权限与审批：按环境（开发/测试/生产）和操作（部署/切换/回滚）设置审批流。
关键设计原则：门户只负责“编排与展示”，不直接操作容器或网络设备；所有变更指令通过 API 下发到基础设施层，保证操作可审计、可中断、可回滚。
3.2 用户角色与职责矩阵
不同角色在门户中拥有差异化的视图和操作权限。下表列出三类核心用户及其典型职责：
| 角色 | 核心关注点 | 门户操作范围 | 审批权限 |
|---|---|---|---|
| 开发者 | 代码版本、构建产物、功能验证 | 提交发布申请、查看发布状态、执行验证任务 | 无审批权，仅可发起 |
| 测试人员 | 环境一致性、流量隔离、回归结果 | 配置测试环境、触发冒烟测试、查看拨测报告 | 可审批测试环境发布 |
| 运维/SRE | 集群健康、流量均衡、回滚速度 | 管理发布模板、调整流量权重、执行紧急回滚 | 生产环境唯一审批人 |
角色隔离示例：开发者无法在生产环境直接切换流量；运维人员不能修改测试环境的冒烟测试用例。所有跨角色操作均需通过门户的审批工作流。
3.3 门户与底层基础设施的关系
自助门户位于“用户界面”与“基础设施”之间，通过统一的 API 网关与下层系统交互。下图展示了门户的架构位置与核心依赖：
门户与底层基础设施的交互遵循以下原则：
- 声明式驱动：门户提交期望状态（如“将 50% 流量切至蓝组”），基础设施控制器负责收敛到该状态。
- 异步回调：基础设施执行完成后通过 webhook 或消息队列通知门户更新状态，避免长连接阻塞。
- 熔断保护：当基础设施返回错误率超过阈值时，门户自动暂停发布流程并通知审批人。
常见误区：不要将门户与 CI/CD 工具（如 Jenkins、GitLab CI）混为一谈。CI/CD 负责“构建与部署”，而发布工程门户负责“流量切换与验证”，两者通过 API 集成，但职责分离。
3.4 门户与 CI/CD 的边界
为了进一步澄清门户的定位，下表对比了发布工程自助门户与典型 CI/CD 工具的核心差异：
| 维度 | CI/CD 工具 | 发布工程自助门户 |
|---|---|---|
| 核心职责 | 代码构建、单元测试、镜像打包 | 流量切换、验证编排、回滚管理 |
| 操作对象 | 源代码、制品仓库 | 运行环境、流量规则、监控指标 |
| 用户视角 | 开发者提交代码后自动触发 | 运维/测试按需发起发布流程 |
| 失败处理 | 构建失败 → 修复代码重试 | 切换失败 → 自动回滚 + 告警 |
| 审批集成 | 通常无内置审批 | 内置多级审批工作流 |
最佳实践：CI/CD 将镜像推送至仓库后，调用门户 API 触发发布流程；门户负责后续的蓝绿切换、验证和回滚。两者通过制品版本号关联，形成完整的“构建-发布”链路。