4、自助门户架构：门户前端、后端服务、配置存储、与CI/CD系统的集成方式
发布质量门禁参数配置自助门户的架构设计，决定了SRE团队能否高效、安全地管理SLO驱动的发布策略。一个典型的四层架构包括：门户前端（用户交互层）、后端服务（业务逻辑层）、配置存储（持久化层）以及CI/CD集成层（自动化执行层）。
架构设计核心原则： 前端无状态、后端可水平扩展、配置存储强一致性、CI/CD集成通过API解耦。
4.1 门户前端
前端是SRE和开发人员配置门禁参数的交互界面，采用单页应用（SPA）架构，通过API与后端通信。核心功能模块包括：
- 参数配置表单：支持SLO阈值、错误预算消耗率、MTTR上限、金丝雀持续时间等关键门禁参数的输入与校验。
- 门禁状态仪表盘：实时展示当前生效的门禁策略、最近变更记录、以及CI/CD流水线的门禁检查结果。
- 审批工作流：对于高风险参数变更（如降低SLO目标），触发多级审批流程，前端展示审批状态与历史。
- 版本对比视图：支持不同版本的门禁参数配置进行差异对比，便于审计与回滚。
前端技术选型建议： 推荐使用 React 或 Vue 3 + TypeScript，配合 Ant Design 或 Element Plus 组件库，可快速构建符合企业UI规范的表单与仪表盘。
4.2 后端服务
后端服务是门户的业务逻辑核心，负责处理前端请求、执行参数校验、管理配置版本、以及对外提供门禁检查API。关键模块如下：
| 模块名称 | 职责描述 | 技术实现要点 |
|---|---|---|
| 参数校验引擎 | 验证用户输入的参数是否符合业务规则（如SLO阈值范围、错误预算消耗率上限） | 基于JSON Schema或自定义规则引擎，支持动态扩展校验规则 |
| 策略编排器 | 组合多个门禁参数形成完整的发布质量门禁策略 | 支持AND/OR逻辑组合，以及条件触发（如仅在生产环境生效） |
| 版本管理模块 | 记录每次参数变更的版本快照，支持回滚到任意历史版本 | 采用乐观锁或MVCC机制，避免并发写入冲突 |
| 审计日志服务 | 记录谁在什么时间修改了哪些参数，以及变更前后的值 | 异步写入日志存储，支持按时间范围、操作人、参数名检索 |
| 门禁检查API | 供CI/CD系统调用的REST/gRPC接口，返回门禁检查通过/阻断结果 | 无状态设计，高并发场景下支持缓存与限流 |
4.3 配置存储
配置存储层负责持久化所有门禁参数定义、策略模板、变更历史以及SLO基线数据。根据不同的数据特性，采用混合存储策略：
- etcd / ZooKeeper：用于存储当前生效的门禁参数配置，要求强一致性与低延迟读取，支持Watch机制实时推送变更到后端服务。
- PostgreSQL / MySQL：用于存储完整的配置版本历史、审计日志、审批记录，支持复杂查询与报表生成。
- 对象存储（MinIO / S3）：用于存储门禁策略的JSON/YAML模板文件，以及CI/CD系统回传的检查结果快照。
存储选型避坑： 不要将所有数据都放在etcd中。etcd适合小数据量（<10GB）的强一致性配置，不适合存储大量历史版本或审计日志。建议将“当前配置”与“历史数据”分离存储。
4.4 与CI/CD系统的集成方式
自助门户需要与现有的CI/CD流水线深度集成，实现发布质量门禁的自动化执行。集成方式分为以下三种模式：
4.5 集成接口规范
为确保CI/CD系统与门户后端的无缝对接，定义以下标准接口规范：
// 门禁检查请求示例（REST API）
POST /api/v1/gatecheck
Content-Type: application/json
{
"pipeline_id": "pl-20250321-001",
"service_name": "payment-service",
"environment": "production",
"deploy_version": "v2.3.1",
"check_type": "pre_deploy",
"slo_context": {
"error_budget_remaining": 0.72,
"current_error_rate": 0.0035,
"latency_p99_ms": 245
}
}
// 门禁检查响应示例
HTTP/1.1 200 OK
Content-Type: application/json
{
"gate_result": "blocked",
"reason": "错误预算消耗率超过阈值：当前8.5%，允许最大5%",
"violated_rules": [
{
"rule_name": "error_budget_consumption_rate",
"threshold": 5.0,
"actual_value": 8.5,
"severity": "critical"
}
],
"check_id": "gc-20250321-abc123",
"timestamp": "2025-03-21T10:30:00Z"
}
集成安全建议： 所有CI/CD系统调用门禁API时，必须使用API 或mTLS进行身份认证。应具备最小权限原则，仅允许调用门禁检查接口，禁止访问配置管理接口。
4.6 架构总结
自助门户的四层架构通过清晰的职责分离，实现了门禁参数配置的灵活管理与自动化执行。前端提供直观的用户体验，后端封装复杂的业务逻辑与校验规则，配置存储保证数据的一致性与可追溯性，CI/CD集成层将门禁策略无缝嵌入发布流水线。这种架构设计使得SRE团队能够在不影响现有CI/CD流程的前提下，快速引入SLO驱动的发布质量门禁能力。