「主干要能发布」。
坏了就别留在主干上等周末。当天修或当天撤。
这次按时间写。先发生什么,中间查了什么,最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开,避免第二天把猜测当成事实。验证用的是改之前的同一条路径,不是换一组更容易过的输入。
评审先看行为对不对,格式可以后改。提交说明写为什么,差异里已经看得到改了什么。主干当天要能发布,不能回滚的变更不要安排在只有一个人值班的时候。告警只留需要人处理的。决定和欠下的债写下来,不放在心里。
记录里保留失败的那一次。只写成功,别人学不到边界。失败时的输出、当时的配置、本来期望发生什么,三样放在一起。修好之后补一句:如果再出现,先看哪一行。没有这句,这篇就只是故事。
复查「主干要能发布」时按这四步,不靠感觉。用改之前的同一组输入再走一遍,结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名,确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。
补充记录。评审先看行为,格式后面再说。提交说明写为什么,差异里已经有改了什么。主干当天要能发布,坏了当天修或当天撤。不能独自回滚的变更,不安排在只有一个人值班的时候。长期分支不如开关。告警只留需要人起来的那几条。新人第一周只做到能跑、能问、能提交。时间和范围写成区间,并写明不做什么。决定和欠下的债用一段话放进仓库。不写下来,两个月后会再吵一次,债也会变成脾气。
操作顺序。1. 评审先看行为是否符合预期,格式随后。2. 提交说明写为什么改,差异里只看得到改了什么。3. 合入主干前确认当天能发布,不能发布就不要合。4. 不能独自回滚的变更,避开单人值班。5. 告警删到只剩需要人处理的几条。6. 新人第一周的完成标准写成能跑、能问、能提交。7. 范围用三行写清不做什么。8. 决定和欠下的债各用一段话放进仓库。少了第 8 步,两个月后讨论会从零开始,债也会变成口头上的不耐烦。