只有命令列表的文档很难在故障中使用。可执行的 Runbook 应让不了解上下文的人知道何时执行、预期看到什么,以及失败后如何停止。

写清前置条件

记录目标主机、权限、依赖版本和影响范围。涉及重启、数据库写入或防火墙时,应把中断窗口放在步骤之前。

每一步都有验证

命令执行成功不等于业务恢复。步骤后应给出服务状态、端口、HTTP 健康检查或关键日志等可观察信号。

回滚与变更配套

回滚不能只写“恢复备份”。应标明备份位置、恢复命令和恢复后检查项,并定期通过演练确认仍然有效。