发布流程

发布流程串联草稿、审批、环境与回滚。所有把规则下发到生产 ordo-server 的动作都必须经过这条流水线。

流程总览

null

发布请求（Release Request）

POST /api/v1/orgs/:oid/projects/:pid/releases
{
  "rulesets": [
    { "name": "discount-check", "from_seq": 17 }
  ],
  "environments": ["staging", "prod"],
  "title": "v1.4 — 增加 VIP 阶梯",
  "description": "..."
}

平台会：

1. 自动跑挂在 ruleset 上的测试套件——失败则阻断创建。
2. 生成与目标环境当前活跃版本的 diff（步骤增删、分支变化、契约对比）。
3. 评估 发布策略 决定需要的审批人。

审批策略（Release Policy）

每个项目可定义多条策略，按优先级匹配：

{
  "name": "prod-strict",
  "match": { "environments": ["prod"] },
  "approvers": {
    "min_count": 2,
    "roles": ["admin"],
    "exclude_authors": true
  },
  "auto_run_tests": true,
  "freeze_window": { "cron": "0 0 * * 5-6", "duration": "48h" }
}

API：/api/v1/orgs/:oid/projects/:pid/release-policies。

审批

• POST .../releases/:rid/approve —— 同意
• POST .../releases/:rid/reject —— 拒绝并附原因
• GET /api/v1/orgs/:oid/releases/pending-for-me —— 列出待我审批

执行与灰度

POST .../releases/:rid/execute

执行时平台向目标 ordo-server 集群同步规则，可选灰度：

操作	端点
暂停	POST .../releases/:rid/pause
继续	POST .../releases/:rid/resume
回滚	POST .../releases/:rid/rollback
当前快照	GET .../releases/:rid/execution
历史	GET .../releases/:rid/history
事件流	GET .../releases/:rid/executions/:eid/events (SSE)

环境的灰度配置：PUT /api/v1/orgs/:oid/projects/:pid/environments/:eid/canary。

回滚

任何已发布的 release 都可一键回滚：平台从历史中找到上一个稳定版本，新建一条 rollback release 并自动通过审批（保留审计链），不直接覆写。

预览

POST .../releases/preview

无需创建 release 即可看到 diff 与策略评估结果，方便发布前的最终确认。