跳到主要内容

规则与规范文档

运维类任务的风险远高于“生成脚本”。真正该先写清的是变更权限、环境差异、回滚、密钥和告警责任。

DevOps 文档分层

载体应该承载什么
AGENTS.md环境边界、IaC 纪律、secret 规则、回滚要求
工具说明默认命令、输出格式、平台入口习惯
runbook / 变更说明执行步骤、检查点、失败回退
handoff 模板风险、监控指标、发布窗口、责任人

最值得固化的长期规则

  • 所有基础设施变更必须可回滚。
  • 所有环境变量和 secret 必须通过正式 secret 管理。
  • 生产变更必须说明验证点、告警和回退条件。
  • IaC 与实际运行状态差异必须可追踪。

可直接复制的 DevOps 模板

模板什么时候先用
基础设施变更 Brief 模板还在界定变更边界、环境和 owner 时
Runbook 与回滚模板需要执行 staging / production 变更时
命令与证据模板需要固定验证顺序、日志和截图证据时
Incident / Handoff 模板需要交班、值班或跨团队 handoff 时

这几份模板的汇总入口在 DevOps 训练包模板

下一步