4. Runbook 基础概念
Runbook（运行手册）是运维领域将“人脑经验”转化为“可执行程序”的核心载体。在变更冻结闸口自动化故障排查场景中，Runbook 定义了从故障发现到恢复验证的完整操作路径，是自动化引擎与人工干预之间的桥梁。
4.1 Runbook 的定义
Runbook 是一份结构化、可重复执行的操作文档或脚本集合，用于指导运维人员或自动化系统完成特定场景下的标准操作。在 SRE 实践中，Runbook 具备以下特征：
- 确定性：每一步操作都有明确的输入、输出和预期结果。
- 可自动化：超过 80% 的步骤可通过 API、脚本或编排工具自动执行。
- 可审计：所有执行记录、决策分支和异常处理均被完整记录。
- 版本化：与代码一样，Runbook 需要纳入版本管理，支持变更追溯。
关键认知：Runbook 不是“操作手册”，而是“可执行的故障处理程序”。在变更冻结闸口场景中，Runbook 是自动化引擎读取的第一份“决策地图”。
4.2 Runbook 的组成要素
一个完整的 Runbook 由三个核心要素构成：触发条件、执行步骤、回滚方案。三者缺一不可，共同形成闭环。
| 要素 | 定义 | 在冻结闸口场景中的示例 |
|---|---|---|
| 触发条件 | 启动 Runbook 的前置条件，包括监控告警、人工指令、定时任务或事件驱动。 | “变更冻结窗口内，某核心服务错误率 > 5% 持续 3 分钟” |
| 执行步骤 | 按顺序排列的操作指令集，包含决策分支、参数传递、API 调用和人工确认点。 | “步骤 1：查询变更记录 → 步骤 2：比对基线配置 → 步骤 3：执行自动回滚” |
| 回滚方案 | 当执行步骤失败或产生预期外结果时，将系统恢复到已知安全状态的备用路径。 | “若自动回滚失败，触发人工介入流程，并锁定该变更批次” |
4.2.1 触发条件详解
触发条件决定了 Runbook 何时被激活。在自动化故障排查流程中，触发条件通常分为三类：
- 阈值触发：监控指标超过预设阈值（如 P99 延迟 > 200ms）。
- 事件触发：特定事件发生（如变更审批通过、部署完成事件）。
- 人工触发：SRE 通过运维平台手动拉起 Runbook。
4.2.2 执行步骤详解
执行步骤是 Runbook 的主体，采用有限状态机模型设计。每一步都包含：
- 操作指令：具体执行的命令、API 调用或脚本。
- 预期结果：操作成功后的可观测状态。
- 异常处理：操作失败时的跳转逻辑（重试、跳过、终止、回滚）。
- 人工确认点：需要 SRE 确认后才能继续的节点。
4.2.3 回滚方案详解
回滚方案是 Runbook 的“安”。在变更冻结场景中，回滚方案必须满足：
- 原子性：回滚操作要么全部成功，要么全部失败并报警。
- 幂等性：多次执行回滚不会产生副作用。
- 时效性：回滚必须在 SLA 规定的时间内完成（如 5 分钟内）。
常见误区：很多团队只编写“正向步骤”，忽略回滚方案。在变更冻结闸口场景中，回滚方案是自动化流程的强制要求，缺失回滚方案的 Runbook 不允许上线。
4.3 Runbook 的版本管理
Runbook 本质上是“可执行的代码”，因此必须纳入版本管理体系。在变更冻结闸口自动化场景中，版本管理直接决定了故障排查的可追溯性和一致性。
4.3.1 版本管理核心原则
| 原则 | 说明 | 实施方式 |
|---|---|---|
| 语义化版本 | 遵循 MAJOR.MINOR.PATCH 格式，每次变更必须更新版本号 | Git Tag + 自动版本号生成 |
| 不可变发布 | 已发布的 Runbook 版本不可修改，只能发布新版本 | 制品仓库存储 + 版本锁定 |
| 变更审计 | 每次版本变更必须关联工单号、变更人和审批记录 | Git Commit Message 规范 + CI 门禁 |
| 灰度发布 | 新版本 Runbook 先在低风险环境验证，再全量推广 | 环境标签 + 流量路由 |
4.3.2 版本管理流程
- 开发阶段：在 Git 仓库中创建 Feature 分支，编写或修改 Runbook YAML/DSL 文件。
- 评审阶段：提交 Pull Request，触发自动化语法校验和模拟执行测试。
- 发布阶段：合并到主分支后，CI 流水线自动生成版本号并发布到 Runbook 仓库。
- 部署阶段：自动化引擎拉取指定版本 Runbook，加载到内存并激活。
- 回滚阶段：若新版本 Runbook 执行异常，自动化引擎自动回退到上一个稳定版本。
最佳实践：在变更冻结闸口场景中，建议将 Runbook 版本号与变更批次号绑定。例如，变更批次
CHG-20250321-001 使用的 Runbook 版本为 v2.3.1，这样在故障排查时可以精确锁定当时执行的逻辑。