4. 自助服务门户架构：前端UI、后端API、编排引擎、资源目录

自助服务门户是平台工程面向开发者的统一入口，其架构设计直接决定了开发者体验（DX）的优劣与平台运营效率。一个成熟的门户架构通常由四个核心层构成：前端UI、后端API、编排引擎和资源目录。每一层承担明确的职责，并通过标准化接口协同工作，形成从“开发者请求”到“资源交付”的完整闭环。

4.1 四层架构总览

下图展示了自助服务门户的典型分层架构及各层之间的核心交互关系。开发者从前端发起请求，经过API网关鉴权后，由编排引擎协调资源目录中的模板，最终通过基础设施即代码（IaC）驱动底层环境变更。

4.2 前端UI：开发者体验的第一触点

前端UI是开发者与平台交互的窗口，其设计目标在于降低认知负荷、提供清晰的引导路径。现代自助服务门户的前端通常包含以下关键模块：

4.3 后端API：抽象与安全的统一网关

后端API层是门户架构的“中枢神经”，负责将前端请求转化为编排引擎可理解的指令，同时承担身份认证、权限校验、请求限流等横切关注点。典型的API设计包含以下端点组：

• 模板端点：GET /api/v1/templates（列表）、GET /api/v1/templates/{id}（详情）、GET /api/v1/templates/{id}/schema（参数Schema）
• 资源端点：POST /api/v1/resources（创建）、GET /api/v1/resources/{id}（状态）、DELETE /api/v1/resources/{id}（销毁）
• 审批端点：GET /api/v1/approvals/pending（待审批列表）、POST /api/v1/approvals/{id}/approve（通过）、POST /api/v1/approvals/{id}/reject（拒绝）
• 审计端点：GET /api/v1/audit-logs（操作日志）、GET /api/v1/metrics（平台使用指标）

// 示例：创建资源的API请求与响应
POST /api/v1/resources
Content-Type: application/json
Authorization: Bearer <>

{
  "templateId": "aws-ecs-service",
  "parameters": {
    "serviceName": "order-api",
    "cpu": 512,
    "memory": 1024,
    "replicas": 3,
    "environment": "staging"
  }
}

// 响应
{
  "resourceId": "res-abc123",
  "status": "provisioning",
  "trackingUrl": "/status/res-abc123",
  "estimatedCompletionSeconds": 120
}

4.4 编排引擎：资源交付的流程大脑

编排引擎是门户架构中最具技术深度的组件，它负责将资源请求转化为可执行的工作流，并管理整个生命周期中的状态转换。编排引擎的核心能力包括：

1. 工作流定义：使用DSL（如Terraform HCL、Pulumi YAML、Argo Workflows）描述资源创建、更新、销毁的步骤序列。
2. 状态管理：维护每个资源实例的当前状态（pending、provisioning、running、failed、deleted），支持幂等重试与回滚。
3. 审批集成：在关键节点（如生产环境部署、高成本资源申请）插入人工审批步骤，支持多级审批链。
4. 事件通知：通过Webhook、消息队列或事件总线，将状态变更实时推送给前端、监控系统或CI/CD流水线。

4.5 资源目录：模板与策略的治理中心

资源目录是平台工程“标准化”的基石，它集中管理所有可被自助申请的资源模板及其关联的元数据、策略和版本。一个设计良好的资源目录应包含以下要素：

下图展示了资源目录的内部结构及其与编排引擎的协作关系：

4.6 四层协作的DORA度量价值

四层架构并非孤立存在，其协作质量直接反映在DORA四大关键指标上。下表总结了各层对DORA指标的具体贡献：