其其网文档中心

首页/系统与基础设施/自动化运维速查/手工操作手册转为自动化剧本
自动化运维速查
自动化基础与选型50 条
查看全部 340 条 →

手工操作手册转为自动化剧本

把手工操作手册转成自动化剧本的关键是把手册里的隐含判断显式化：区分输入值、判断条件、动作与校验，把「看起来没问题就继续」这类人工判断改写成可判定的条件，把「出问题就回滚」改写成可执行的回退步骤；转换后要用同一场景验证结果与手工执行一致。

自动化运维速查系统与基础设施更新于 2026-10-17
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌​​‌​‌‌‌‌​‌‌​​​​‌​‌‌‌​‌​‌​‌‌‌​‌​​​‌‌​‌‌‌‌​‌‌​‌‌​‌​‌‌​​​​‌​‌‌‌​‌​​​‌‌​‌​​‌​‌‌​‌‌‌‌​‌‌​‌‌‌​​​‌​‌‌‌‌​‌‌‌​‌​​​‌‌‌​​‌​​‌‌​​​​‌​‌‌​‌‌‌​​‌‌‌​​‌‌​‌‌​​‌‌​​‌‌​‌‌‌‌​‌‌‌​​‌​​‌‌​‌‌​‌​‌‌​‌​​‌​‌‌​‌‌‌​​‌‌​​‌‌‌​​‌​‌‌​‌​‌‌​‌‌​‌​‌‌​​​​‌​‌‌​‌‌‌​​‌‌‌​‌​‌​‌‌​​​​‌​‌‌​‌‌​​​​‌​‌‌​‌​‌‌‌​​‌​​‌‌‌​‌​‌​‌‌​‌‌‌​​‌‌​​​‌​​‌‌​‌‌‌‌​‌‌​‌‌‌‌​‌‌​‌​‌‌​​‌​‌‌​‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌​‌​‌‌​​​​‌​‌‌‌​‌​‌​‌‌‌​‌​​​‌‌​‌‌‌‌​‌‌​‌‌​‌​‌‌​​​​‌​‌‌‌​‌​​​‌‌​‌​​‌​‌‌​‌‌‌‌​‌‌​‌‌‌​​​‌​‌‌‌​​‌‌​‌​​​​‌‌‌​‌​​​‌‌​‌‌​‌​‌‌​‌‌​​

手册里藏着判断

手工操作手册通常写成指令序列，但执行者实际在做的事远多于照抄命令：查看输出是否正常、依据经验决定是否继续、遇到异常时选择绕行或停止。这些判断是流程的真正组成部分，只是没有被写下来。转成自动化时，要把每条手工命令拆成输入值、判断条件、动作与校验四部分，并明确异常路径；否则脚本只能在一切正常时工作。

基本信息

转换对象手工操作手册、故障处置步骤、发布流程
拆解要素输入值、判断条件、动作、校验
重点把隐含判断显式化为可判定条件
验收同一场景下手动与自动结果一致

转换步骤

  • 跟岗记录：随执行者实际走一遍流程，记录所有临时决定。
  • 标注判断点：把「看情况」「没问题就继续」标出来并追问答错标准。
  • 抽取变量：把每次不同的值（地址、路径、端口）抽成参数。
  • 分离校验：为每个动作补写可自动判定的成功条件。
  • 补全异常路径：为每个判断点写明不满足时的处理方式。
  • 同场景验证：用一次真实变更场景对比两种方式的结果与耗时。
  • 保留兜底：手工流程保留到自动化在真实故障场景验证过为止。

手册要素到剧本的映射

手册内容剧本中的位置注意事项
命令序列任务列表保留顺序与注释
「检查是否正常」判断条件与断言写出可判定的阈值
每次不同的值变量与参数提供默认值并校验
「出错就回滚」失败处理与回退任务回退动作也要幂等
「一般几分钟」等待与轮询改为状态轮询加超时
经验判断条件分支无法编码时保留人工确认
转换过程中最有价值的产出不是脚本，而是那份被写清楚的判断条件清单：它同时可以改进手工手册，也能用于评审自动化逻辑是否与原流程等价。
无法编码的判断不要硬编码：例如需要业务确认的场景，把它做成等待确认的闸门比用启发式规则代替更安全。

易错点

  • 直接翻译命令序列：手工执行中的判断全部丢失，脚本在异常路径上给出错误决策
  • 手工经验被替换成猜测规则：用模糊条件代替人工判断，行为不可预测且难以解释
  • 遗漏校验步骤：动作执行成功但结果未生效，问题在后续环节才暴露
  • 过早删除手工流程：自动化在异常场景下失效时，团队失去可用手段

数据来源与参考

  • ITIL 4 知识管理与变更支持实践指南
  • Google SRE 工作手册（运维手册与自动化手册章节）
  • Red Hat《Ansible 官方文档：Playbook 结构》

整理校对：其其网ICT文档中心 · 本页地址：docs.qiqicto.com/automation/transforming-manual-runbook-to-automation.html

继续搜索

常用关键词：3389tracerouteiptables子网掩码docker

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌​​‌​‌‌‌‌​‌‌​​​​‌​‌‌‌​‌​‌​‌‌‌​‌​​​‌‌​‌‌‌‌​‌‌​‌‌​‌​‌‌​​​​‌​‌‌‌​‌​​​‌‌​‌​​‌​‌‌​‌‌‌‌​‌‌​‌‌‌​​​‌​‌‌‌‌​‌‌‌​‌​​​‌‌‌​​‌​​‌‌​​​​‌​‌‌​‌‌‌​​‌‌‌​​‌‌​‌‌​​‌‌​​‌‌​‌‌‌‌​‌‌‌​​‌​​‌‌​‌‌​‌​‌‌​‌​​‌​‌‌​‌‌‌​​‌‌​​‌‌‌​​‌​‌‌​‌​‌‌​‌‌​‌​‌‌​​​​‌​‌‌​‌‌‌​​‌‌‌​‌​‌​‌‌​​​​‌​‌‌​‌‌​​​​‌​‌‌​‌​‌‌‌​​‌​​‌‌‌​‌​‌​‌‌​‌‌‌​​‌‌​​​‌​​‌‌​‌‌‌‌​‌‌​‌‌‌‌​‌‌​‌​‌‌​​‌​‌‌​‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌​‌​‌‌​​​​‌​‌‌‌​‌​‌​‌‌‌​‌​​​‌‌​‌‌‌‌​‌‌​‌‌​‌​‌‌​​​​‌​‌‌‌​‌​​​‌‌​‌​​‌​‌‌​‌‌‌‌​‌‌​‌‌‌​​​‌​‌‌‌​​‌‌​‌​​​​‌‌‌​‌​​​‌‌​‌‌​‌​‌‌​‌‌​​