技能 Core

生产就绪探针

部署类生产就绪门禁——一个只读的测试↔生产运行器对称性探针,在生产环境验证通过之前阻止合并提案与归档。混合模式:有项目契约时确定性执行,无契约时按 agent 检查清单执行。

概述

Prod-Readiness Probe 是部署类任务的阻断性门禁——即触及部署面(systemd unit 文件、sudoers、CI 切换作业、.env-deploy 模板)的工作。它在两个流水线阶段运行:/dr-qa 第 4g 层(在流水线可提出合并之前)和 /dr-archive 第 0.4 步(在任务可被归档之前)。

为何存在

部署或切换变更可能在测试运行器上通过所有测试,却在第一条生产命令上失败——典型情况是生产主机的 sudoers 缺少测试运行器已有的 NOPASSWD 规则。流水线过去会在从未检查生产运行器是否与测试运行器对称的情况下,就建议合并并归档此类变更。此门禁强制进行该检查:框架在建议合并之前预测生产影响并验证就绪状态,并拒绝归档生产上线不完整或未经验证的任务。

检查内容

  • sudoers 对称性——部署所需的每种 NOPASSWD 命令形态在生产上均与测试上完全一致。
  • PATH 一致性——部署/服务用户在生产上的 PATH 与测试一致。
  • 监听端口——服务的端口在生产上空闲(或由预期的 unit 占用)。
  • Systemd unit——所需 unit 存在且已启用 / 运行中。
  • 运行时版本——node / redis / 其他运行时满足声明的最低版本。

判定词汇

SKIP(非部署类)、PASS(对称性已验证)、FAIL(发现不对称——禁止合并 / 归档)、BLOCKED(探针无法运行且无操作员确认——禁止合并 / 归档)。BLOCKED 在主机不可达时绝不会自动转为 PASS;沉默不等于成功。

混合执行

当项目编写了可选的 datarim/deploy-readiness.yml 契约(由专用 shell 校验器验证)时,探针执行确定性的三方比较——测试运行器实际值 vs 生产运行器实际值 vs 声明值。当契约缺失时,探针回退为针对相同条目的 agent 驱动检查清单调查。框架核心保持技术栈无关;只有项目特定数据位于可选契约中。

生产环境为硬门禁

每个探针操作都是只读的——sudo -l、systemctl status、ss、redis-cli info server、node --version。探针是传感器,绝不是执行器:它不执行写入、不重启、不编辑 sudoers。当发现缺口时,它预测影响并报告;修复是明确的操作员操作。

加载方

/dr-qa 第 4g 层和 /dr-archive 第 0.4 步,仅针对部署类任务。