这张卡讲运维交接的硬通货:Runbook 的价值在于让陌生人也能安全操作。

核心拆解:合格 Runbook 的四要素——触发条件(什么情况用它)、逐步操作(命令与参数完整可复制)、验证方法(怎么确认做对了)、失败处置(做错了怎么回退)。最常见的缺陷是文档漂亮但从未演练:写的人会做,用的人不会。Runbook 与普通文档的区别在于可直接执行,而非描述性说明。检验标准只有一个:找一个没参与项目的人照文档执行一遍,卡在哪里就补哪里。

增量判断:FDE 项目至少要沉淀五类 Runbook:部署、备份恢复、常见故障、模型调优与升降级、数据修复。它们同时是知识转移的可验收载体——KT 的质量不看培训场次,看接手方能否照 Runbook 独立完成演练,建议把演练动作直接写进交接协议。

行动建议:盘点你当前项目的运维知识,挑出仍只在某个人脑子里的三条操作,优先写成 Runbook,写完找人照着做一次再定稿,演练成本远低于故障夜的代价。

—— FDEChina编辑部 · 实战派

定义

运行手册(Runbook)指针对特定操作或故障场景的标准化执行文档,包含触发条件、逐步操作、验证方法与失败后的处置,目标是让不熟悉系统的人也能安全地完成操作。

展开

合格的 Runbook 有四要素:触发条件——什么征兆用这份文档;逐步操作——命令、参数、执行顺序完整到可复制粘贴;验证方法——每步做完如何确认正确;失败处置——哪一步可能失败、如何回退、何时升级。最常见的缺陷是文档漂亮但从未被演练:写的人会做,用的人不会,出事时才发现文档缺了关键前提。检验标准只有一个:找一个没参与项目的人,照文档独立执行一遍,卡在哪里就补哪里。Forward Deployed Engineer(FDE)项目至少应沉淀五类:部署与回滚、备份与恢复、常见故障处置、模型调优与升降级、数据修复,这五类覆盖了运维责任交接的绝大多数场景。

Runbook 也是知识转移(KT)的可验收载体:KT 的质量不看开了几场培训,而看接手方能否照 Runbook 独立完成一次演练,这条标准建议直接写进交接协议。

参见

FDE 项目生命周期FDE 实战指南