SuperAPI AI 工具集

deployment-verification-agent

部署与运维

查看项目

更新于 10-16 04:20

技能介绍

用途

Deployment Verification Agent 是一个部署验证智能体,专门用于处理涉及生产数据的风险性部署。它的目标是为工程师提供具体、可执行的检查清单,避免在发布时凭猜测操作。当 PR 触及生产数据、数据库迁移、数据处理逻辑、回填或数据转换,或任何可能静默损坏/丢失数据的变更时,可以调用该智能体。

主要能力

该智能体围绕以下核心验证目标展开工作:

  1. 识别数据不变量:确定部署前后必须保持为真的具体数据条件,例如所有现有 Brief 邮件在 briefs 中仍可选择、旧列和新列不能同时为 NULL、status=active 的记录数不变、外键关系保持有效等。

  2. 创建 SQL 验证查询:编写只读检查来证明正确性,包括基线计数、可能引发问题的数据检查、映射数据存在性验证等。文档中会记录预期值和容差,任何偏离预期都意味着停止部署。

  3. 记录破坏性步骤:对每个破坏性步骤(如添加列、回填数据、启用功能)记录命令、预估运行时间、批处理大小和回滚方式。

  4. 定义回滚行为:明确是否可以回滚,以及需要恢复哪些数据。回滚选项包括:可以回滚(双写保留旧列)、可以回滚(有迁移前数据库备份)、部分回滚(可还原代码但数据需手动修复)、不可回滚(记录为何可接受)。

  5. 规划部署后监控:定义指标/日志、告警条件和仪表盘链接,覆盖部署后前 24 小时。

使用方式

该智能体输出一份完整的 Go/No-Go 检查清单,工程师可以直接执行。清单结构包括:

  • 部署前(必需):运行基线 SQL 查询、保存预期值、验证 staging 测试通过、确认回滚计划已审查。
  • 部署步骤:部署提交、运行迁移、启用功能标志。
  • 部署后(5 分钟内):运行验证查询、与基线比较、检查错误仪表盘、在控制台抽查。
  • 监控(24 小时):设置告警、在 +1h、+4h、+24h 检查指标、关闭部署工单。
  • 回滚(如需要):禁用功能标志、部署回滚提交、运行数据恢复、用回滚后查询验证。

具体验证内容包括:部署前运行只读 SQL 审计(如按状态分组计数、检查必填字段为 NULL 的记录、验证映射数据存在);部署后 5 分钟内运行验证查询(如检查新列为 NULL 而旧列非 NULL 的记录数应为 0、验证旧列到新列的映射唯一性、比较计数与基线);部署后 1 小时运行控制台抽查(如随机抽取记录验证映射正确)。

适用场景

  • PR 涉及带数据变更的数据库迁移
  • PR 修改数据处理逻辑
  • PR 涉及回填或数据转换
  • 数据迁移专家标记了关键发现
  • 任何可能静默损坏或丢失数据的变更

限制

资料中未提供该智能体的具体平台依赖、安装命令、收费模式或价格信息。其输出为检查清单和 SQL 查询模板,实际执行需要工程师在相应环境中运行。资料中未说明其支持的数据库类型或编程语言范围。