2026年8月14日

部署后环境差异技能——在归档前捕获配置漂移

Datarim 的 post-deploy-env-diff 技能如何在 /dr-archive 时对比主机上的 env 文件与仓库模板,揭示仍携带旧默认值的生产配置。

一次部署可能在 .env.example 中发布新的默认值,却让主机上实际运行的 .env 保持不变。流水线报告成功。生产环境却悄悄运行着旧设置。post-deploy-env-diff 技能的存在,就是为了在任务被视为关闭之前揭示这一差距。

门禁何时触发

当以下两个条件同时成立时,该技能会在 /dr-archive 期间加载:关闭的任务触及了 env 模板——.env.example、config.sample.yaml 或类似的已检入默认值文件——并且该任务涉及部署到主机,而该主机的实际配置位于仓库之外的磁盘上。如果部署流水线已在每次运行时将模板复制到主机,门禁会自动跳过。

差异对比做了什么

对于合并基与 HEAD 之间默认值发生变化的每一行 KEY=value,门禁通过 ssh <host> grep "^KEY=" <path> 从主机配置中读取匹配的键并进行比较。当主机上的值仍携带旧默认值时,门禁会向归档文档的 Operator Handoff 部分写入一行——指明键、新默认值、主机路径以及要运行的确切命令。在操作员翻转该值或记录至少 50 个字符的明确理由以接受该漂移之前,人类摘要中的“所有 V-AC 已满足”声明会被阻止。

门禁不做什么

门禁是只读的。它从不修改主机上的文件,从不重启服务,也从不自动应用新的默认值。切换操作由操作员负责。这一边界是有意为之:生产配置变更不可逆,需要人工授权。门禁的职责是让漂移可见,并在漂移存在期间阻止归档被标记为“完成”。

它防止的故障类别

“部署宣称了新的默认值,但生产环境在 N 小时内仍运行在旧默认值上”这一类别,在流水线中没有任何步骤将部署意图与部署状态进行差异对比时,会悄无声息地发生。该门禁是归档时的只读探测——运行成本低,并且填补了部署脚本经常留下的缺口。请参阅 post-deploy-env-diff 参考,或阅读 Datarim 是什么以了解更全面的图景。