运维交接文档:让下一个人十天上手
人员流动是常态,交接文档是站点的说明书。文档结构与维护机制。
单点依赖是运营的最大隐患,交接文档把个人知识变成组织资产。
文档结构六部分
一:资产清单,域名、服务器、账号、证书的完整台账;二:架构说明,系统组成、数据流、依赖关系;三:常规操作,发布、备份、监控的处理步骤;四:故障手册,历史故障与处理记录;五:例行事务,周期性任务的时间表与做法;六:联系人网络,服务商、供应商、关键合作方。
写文档的技巧
写给不了解的人看:假设读者零背景,术语解释、截图、具体路径;操作步骤可复制执行:命令与配置直接可粘贴,而不是描述性语言。
维护机制
变更即更新:任何架构与流程变更,文档同步修改;季度校对:每季度全面核对一次,过期内容比没有更害人;交接演练:新人入职按文档独立操作一周,暴露的断点立即补齐。
一个标准
交接文档的质量,以新人能否十天独立值班为验收线。