发布单贯穿评审到归档

版本与发布管理:把每次上线变成可控步骤

固定发布窗口、变更分级、灰度观测与回滚预案四件事对齐之后,上线不再依赖某个人的经验判断,而是一套团队都能照着执行的流程。

变更 全程留痕 灰度 随时可停 回滚 限时完成
01

发布窗口与冻结期:把时间钉在业务低峰

窗口按季度排定,常规版本固定在周二与周四晚间二十点开始,单次窗口不超过两小时。发布单需提前两个工作日提交并冻结,冻结之后只放行已完成评审的变更,新增内容顺延到下一个窗口,避免临到上线还在改代码。

冻结期内确有必须进入的需求,走例外单:写明业务影响面、回退方式与责任人,由发布负责人与业务方共同签批。窗口结束后半小时内输出结果通告,说明实际发布项、跳过项与遗留观察点。

窗口 周二 · 周四 20:00 提前冻结 48 小时 例外单 双签放行
02

变更分级与审批路径:不同风险不同重量

变更按影响面分成三级:L1 涉及配置项、文案与静态资源,由模块负责人确认即可上线;L2 是模块版本升级与接口调整,需测试结论与回归清单;L3 覆盖架构调整、数据迁移与计费链路,要求双人复核并附带回滚演练记录。

分级不是为了增加流程,而是把审批重量放在真正有风险的地方。审批链路控制在半小时内完成,超时自动提醒上级,避免发布卡在某个人的待办列表里。

分级 L1 / L2 / L3 L3 复核 双人签批 审批时限 ≤ 30 分钟
03

灰度放量与观测指标:每一步都有判断依据

首批放量控制在百分之五的流量,观察三十分钟,重点看错误率、接口耗时、下单成功率与消息堆积四组指标。数据平稳后依次放量到百分之二十五与全量,每一档之间保留观察区间,不放量就停留在当前档位继续看。

观测面板在发布前就配置好,不在上线当晚临时拼指标。熔断阈值提前写进发布单,一旦触发由值班人员直接执行,无需再逐级请示。

放量节奏 5% → 25% → 100% 观测指标 12 项 单档观察 ≥ 30 分钟
0krtech 版本与发布管理中的灰度放量观测面板示意

灰度期间的观测面板:错误率、耗时与业务成功率同屏呈现,异常阈值直接标注在曲线上。

04

回滚预案与数据兼容:先想好怎么退

每个版本在提交发布单时必须附带可执行的回滚脚本,脚本在预发环境跑通过一次才算有效。应用层回滚依靠上一版本镜像,通常六到十分钟完成;配置类回滚切回旧配置文件,一分钟内生效。

数据库变更遵循向前兼容:新增字段先允许为空,旧版本代码照常可读;涉及结构重写时保留双写窗口,待新旧两版同时稳定后再清理冗余表。这样即使回滚,数据也不会出现缺口。

应用回滚 ≤ 15 分钟 结构变更 向前兼容 双写窗口 7 天
05

复盘记录与归档:一次发布留下可查的证据

发布结束二十四小时内产出记录,内容包括本次发布项清单、灰度曲线截图、异常事件与处理过程、遗留风险与下次窗口的处理安排。记录归档到统一目录,按系统与版本号检索,不依赖个人电脑里的临时文档。

复盘只讨论可改变的动作:哪个检查项漏了、哪个阈值定得不合理、哪一步等待时间过长。结论要落到具体条目和责任人,下一次窗口直接对账。

归档时限 24 小时内 记录结构 5 段固定模板 检索维度 系统 · 版本 · 窗口

发布模式怎么选

同一套系统里不同模块可以采用不同模式,关键是提前对照回滚耗时与适用场景做出选择。

发布模式 适用场景与节奏 回滚方式与风险控制
滚动发布 实例分批替换,十分钟内完成。适合无状态服务与内部管理系统,改动集中在一个模块时最省资源。 切回上一版本镜像,约六到十分钟恢复。发布期间保持至少一个旧实例在线,避免全部中断。
蓝绿切换 两套环境并行运行,切流在秒级完成。适合交易、结算等不能停顿的核心链路。 流量切回绿色环境,一分钟内生效。两套环境需保持配置一致,切换前做一次连通性核对。
灰度放量 按用户比例逐步放量,周期从两小时到两天不等。适合新功能、策略调整与算法更新。 比例归零即可停下,现场数据保留。前提是新旧逻辑在数据层互不干扰。

选择依据:先看业务能否中断,再看回滚需要多久,最后看数据层能否兼容新旧两版。

15分钟

版本回滚的可执行时限,超出即视为发布事故

98.6%

近半年发布一次通过的比例,含常规与紧急版本

48小时

发布单提前冻结时间,例外变更需双签放行

12项

灰度期间持续观测的指标,阈值写入发布单

常见问题

实际项目里最常被问到的六个问题,答案直接写进发布规则里。

可以,但需要代价。遇到监管上线、大促或月度结算日,可提前三个工作日提交窗口调整申请,写明影响业务面与替代时段。调整通过后同步更新发布日历,相关团队的冻结期一起顺延,避免两个时间表并行导致有人按旧窗口操作。

把放量比例归零即可,不需要重新发布一版回退包。前提是灰度开关按用户维度控制,新旧逻辑同时在线且数据互不冲突。值班人员拥有直接停量的权限,先止住影响再排查原因,事后在记录里补齐判断依据。

结构变更按向前兼容处理:新增字段先允许为空,旧代码继续可读;涉及重写时保留双写窗口,新旧两版同时写入,等两边数据核对一致后再下线旧结构。这样一来应用回滚时不会碰到数据缺口,也就不需要单独准备数据回滚脚本。

紧急单压缩的是评审等待,不是记录环节。允许在十五分钟内完成口头评审并直接上线,但变更内容、影响范围、验证方式与回滚动作必须在四小时内补齐到发布单里。紧急单每月单独统计,频次过高说明前面的检查项没有起作用。

按影响面排序,同一窗口内串行执行,不并行发布。共享组件或中间件的变更排在最前,其余模块在其稳定后再动。每个团队给出各自的观察人,发布期间保持在线,问题出现时由发布负责人统一指挥停或退。

会。每次发布归档一份记录,包含变更清单、灰度曲线、异常处理与复盘结论,按系统与版本号整理后移交。交付期结束后这些记录留在你们自己的目录里,后续接手团队可以按版本号追溯任意一次上线的完整过程。

把下一个版本放进可控的发布节奏

提交一次发布现状摸底,我们会给出窗口安排、分级规则与回滚清单的初版建议,连同需要补齐的检查项一起列清楚。

0krtech 发布记录与版本归档资料示意