是否有人有在进行生产变更时使用的运行手册的良好示例?

是否有人有在进行生产变更时使用的运行手册的良好示例?

我一直对 IT 团队如何规划生产变更很感兴趣。通常我们使用运行手册来规划变更的关键步骤以及撤销计划。我很想知道我们是否可以向其他人学习以及如何最好地记录运行手册。

答案1

我更喜欢带注释和打印的脚本。
它们具有记录和自动化的双重优势。

但是,采取更全面的方法,通常有很多事情需要跟踪,
脚本仅适用于需要按顺序完成的事情。

当涉及大量笔记时,我更喜欢本地托管的 Wiki(个人的或者团体
它可用于

  1. 通过链接引用您的工具并写下快速笔记
    • 列举联系人和升级参考
    • 根据关键词记录紧急步骤
    • 备份位置和恢复顺序
    • 托管可搜索的常规需求和解决方案记录;这样人们在查看完这些内容后就会来找你

但是,只要保证位置安全即可——您不希望在紧急情况下无法访问数据。

这是一个古老的Microsoft Technet SQL Server 运行手册用于捕捉一般想法的页面。

答案2

我做什么:

所有需要从已安装的操作系统基线更改的服务器配置均由 Chef 管理,这些配置存储在模块(称为 cookbook)中,然后通过 Git 存储在版本控制中。

大多数配置都是在测试系统(通常是 VM 映像或简单的 EC2 实例)上手动完成的,然后编写配置配方以涵盖更改的所有各个组件。更新环境工作流程如下:

  • 在适当的系统中创建需要进行更改的票据。
  • 记录所有变化的原因和内容。
  • 编辑在目标系统上发生更改所需的配置方案、模板、文件等。
  • 将更改提交到本地存储库并推送到主版本控制服务器。
  • 更新票据以供同行评审变更。
  • 更改已签署,并且更改已部署到 Chef 服务器,因此它知道更新的内容。
  • 在客户端上手动运行 Chef,或者根据更改的要求让其自动运行。(我不会在超过六个系统上手动运行)。

Chef 的操作模式是,如果运行客户端时出现问题,例如包不存在、找不到模板文件或出现许多其他问题,则失败。修复问题、记录在票据中,然后重新运行客户端。

具有变更业务需求的人员验证变更是否成功,然后关闭票据。

Chef 专用,因为我用的是这个。用适合你环境的工具替换,如果你没有使用配置管理工具,你需要看看一些东西,因为它使整个过程更加强大和可靠。更不用说可扩展性了。

答案3

对于真正关键和敏感的更改,我通常会准备一个文本文件,其中包含我将使用的实际命令,并使用 #comments 解释发生了什么。这样,我可以快速将它们剪切粘贴到终端中。

答案4

我赞同 jtimberman 帖子背后的基本想法,而 puppet 是我选择的工具。

相关内容