部署记录可以帮助其他人把用户看到的结果与一次改动联系起来。先记录时间、环境、源代码版本和产物,再加上检查结果以及后续采取的措施。
部署 · 第 6 课
部署记录
学习从简短的发布时间线还原部署和回滚过程。
说明改动内容
这份练习记录追踪了一次上线过程。为了方便阅读,标识都做了简写。
UTC Target Commit Artifact Observation
09:00 staging 8a61e1 digest-C version 3, home returned 200
09:12 prod 8a61e1 digest-C version 3, home returned 503
09:18 prod 72b110 digest-B version 2, home returned 200
HTTP 200 表示请求成功。HTTP 503 表示当次请求无法得到可用的服务。写实际记录时,请把检查方法和地址同结果一起保存。
哪一行记录了生产环境中首次观察到的 digest-C 行为?

解释回滚
最后一行显示环境回到了 digest-B。版本检查和首页响应描述了回滚后的结果,没有解释先前失败的具体原因。原因尚无证据时,先将假设与确认的结果分开。
关于 09:18 的结果,可以怎么说?
把记录交给下一位同事
接手的人需要按相同范围复查。请记录如何测量、带时区的时间戳,以及生成该产物的构建链接(如果有)。原因仍不明时,也要写清下一步准备检查什么。
哪个细节能帮助下一位审查者复现首页检查?
记录实际运行的产物
部署说明中的标签可能在发布以后改变指向。如果服务已经报告第 2 版,应同时记下便于阅读的标签和实际运行的产物。即使仓库里的标签之后改了指向,这两个值仍能帮助别人核对本次发布。
发布说明中写的是 site:2。补充哪项信息可以让之后的比较更可靠?
课程已完成
你已完成 部署记录
现在,你可以看懂发布时间线,并把它交给其他人复查。
在记录中找出环境、修订版本和产物。
根据观察结果描述回滚。
为下一次检查保留足够的信息。