归藏 Wiki / 工程流程 / 发车节奏

发车节奏与分支约定

最后编辑:2026-10-12 luyian · 页面版本 22 · 复审:2027-01(平台组)

本文约定平台组各服务的发车(release)节奏、冻结期与热修流程。适用于文档站、状态页、帮助中心等发布站,以及 观澜/重明 的控制台前后端;训练平台与存储服务另有发布窗口,见各自手册。

1. 发车窗口

窗口时间适用
常规发车每周三 14:00–17:00发布站、控制台小版本
夜间发车每周四 02:00–05:00涉及数据库迁移或重启的服务
冻结期每月最后 3 个工作日、法定长假前 2 天除 P1 修复外不发车
热修随时,需两人复核只允许 P1/P2 修复,禁止夹带功能
2026-10 起,文末这条容易踩:常规发车日如果当天有 P2 未闭环事件,自动取消发车,顺延到下个窗口(此前是“视情况”,导致 2026-08 一次带病发车)。

2. 分支约定

# 常规发车摘要命令(平台组内部脚本)
./tools/release.sh --branch release/2026.10 --dry-run
# 输出:待合入 12 个变更、3 个文档更新、1 个已知风险项

3. 发车前检查

  1. CI 全绿(单元、构建、链接检查);文档站的链接检查单独跑,失败不阻塞但需在发布说明标注。
  2. 数据库变更单已评审,回滚脚本随变更单一并提交。
  3. 监控看板已加对应面板,告警规则变更提前 1 个窗口生效。
  4. 发布说明(release note)在发车前 1 小时贴到值班群;文末附回滚命令。

4. 回滚

发布站回滚 = 重新部署上一个发布版本,2 分钟内完成;服务类回滚以镜像 tag 为准,禁止现场改配置救急。2026 年内发生过 3 次回滚,两次因为发布站链接检查漏跑导致导航断裂,一次因为控制台灰度比例配错。

5. 文档与发布的关系

与发布 tag 绑定的文档需在 tag 打完后 24 小时内更新;文档站的版本号(如 dz-2026.10.2)随发车递增,回滚时版本号不回收,避免缓存混淆。文档内容本身不进 CI 校验范围(历史原因,见 文档中心 v2 维护约定)。

相关:值班手册 · 版本记录 · 路线图