展开知识库目录

部署前检查什么:构建、变量、数据库、域名和回滚

上线不是运行一条 deploy 命令。

先把问题看准

部署前先证明构建物、配置和回滚都存在

上线不是运行一条 deploy 命令。代码、依赖、环境变量、数据库、域名、证书、健康检查、监控和回滚点必须对应目标环境。

第 1 步

冻结发布版本

记录提交、构建命令、依赖锁和产物校验,确保发布内容与已测试版本一致。

把涉及的文件、目录、版本、命令和实际输出写进记录;代码变化同时保留 diff 与测试结果。

第 2 步

核对环境与密钥

逐项比较环境变量名称、来源、scope 和缺失行为,生产值不进入日志或构建产物。

确认“核对环境与密钥”已经有可回查结果,再进入“处理数据库与依赖”;依据仍然来自猜测时,把缺口单列并停在当前步骤。

第 3 步

处理数据库与依赖

迁移、备份、兼容窗口、外部服务和域名证书有执行顺序与负责人。

确认“处理数据库与依赖”已经有可回查结果,再进入“定义健康与观察”;依据仍然来自猜测时,把缺口单列并停在当前步骤。

第 4 步

定义健康与观察

写关键 URL、请求、队列、错误率、延迟和业务指标,明确观察时间和放行阈值。

确认“定义健康与观察”已经有可回查结果,再进入“验证回滚”;依据仍然来自猜测时,把缺口单列并停在当前步骤。

第 5 步

验证回滚

记录上一稳定版本、配置和数据库恢复方式;不可逆迁移使用向前修复或兼容方案。

需要修改时先限定文件和行为范围,无法说明回滚方式或影响面的动作先不执行。 完成后把证据归入“部署前检查表与回滚点”。

完成后应能在“部署前检查表与回滚点”中找到与这一步对应的记录;仍需靠猜测补全,就停在这里。

做到这里就可以停

部署决定停在责任人确认前

检查表通过后由有权限的人批准执行。发布后用真实请求和监控验证;任何关键指标超阈值按预先规则回滚,不边看边临时决定。

进一步核对

参考资料与核对入口