docs: 记录规则管理双环境发布与验收结果

2026-09-06 22:44:24 +08:00
parent e4f93f7193
commit f885f0b907
3 changed files with 28 additions and 0 deletions
@@ -290,3 +290,13 @@ cmpp-sending-monitor以cmpp-api:cmpp-security运行，TZ=UTC，PostgreSQL池上
 PostgreSQL备份不能直接把含Prisma专用schema参数的DATABASE_URL交给libpq工具；本次以进程内URL解析取得连接项，经PG环境变量调用pg_dump，既不输出连接秘密，也不修改应用连接配置。已有备份失败文件不算有效资产，必须取得成功dump、pg_restore目录和摘要后再发布。

 测试环境保留6条【测试演示】监控历史告警及36个初始快照，前缀qa-monitor-demo-20260906，规则表保持空；这些是人工验收数据，不能迁到预生产或当作供应商质量事实。生成脚本留在本机%TEMP%/cmpp-monitor-fix-20260906和测试机/tmp/cmpp-seed-monitor-alerts-20260906.cjs，未加入生产启动流程。工作区原有认证/部署规范改动仍单独保护，本轮功能提交GCM推送首试成功；验收文档c51255d首次推送返回Failed to authenticate user，核对helper后在同样进程级GCM_INTERACTIVE=never/GIT_TERMINAL_PROMPT=0下仅重试一次成功，远端回读确认。未修改认证配置，首次失败内部原因仍未查明。
+
+## 2026-09-06 整体兜底规则管理局部发布
+
+功能版本e4f93f7193496a204efe4e753018a1c1ceb35742已推送，测试22:27:37、预生产22:34:24完成应用发布。发布包来自精确提交，907份源码逐项验证；本次前端/API变更，无依赖、schema、Gateway或Worker契约变更，故仅重启cmpp-api。保留dist下Gateway、安全代理二进制以及旧哈希前端资源，避免重启无关进程或中断旧浏览器会话。
+
+测试恢复资产/var/backups/cmpp-platform/rule-manager-20260906T222440；预生产/opt/cmpp-platform-backups/rule-manager-20260906T222419。PG/Redis/应用/配置及SHA256已验证，数据盘与备份入口保护通过，未演练恢复。预生产备份位于数据盘、运行目录位于系统盘，不能直接rename跨设备目录；本次失败发生在旧dist尚未移动时，校验已复制源码后改在/opt/cmpp-rule-manager-previous-e4f93f7保留previous-dist/previous-api-dist并切换。后续发布应在运行目录同文件系统准备原子切换及应用回退目录，独立恢复包仍写受保护数据盘，不改备份链接。现有logs仍依赖历史运行目录，不清理。
+
+Windows内置tar解压含中文路径的完整归档曾报Invalid empty pathname；本轮用Python tarfile直接读取提交归档计算907文件摘要，并在Linux解压。归档生成、读取和校验分别检查退出状态，失败时生成的残缺压缩包不得发布。Prisma URL通过进程内解析传给PG工具；Redis备份使用已核验REDIS_HOST/PORT及需要时的受限认证环境，不能假定一定存在REDIS_URL。
+
+发布后两环境服务/API/真实PG/三个业务Stream/HTTP资源通过，监控检查complete=true、pendingReceipts0；API重启之外既有PID保持。预生产上游6/6；测试6/0是发布前既有状态。用户提供的现有预生产管理员已完成三尺寸登录后只读验收，取代前一发布记录中的“缺少有效管理员入口”遗留项；保留原有2条规则和3条历史版本，不复制测试规则或演示告警。临时公网浏览器连接关闭经连通性复验后通过，不修改网络/认证配置。完整证据及测试规则v4恢复继承记录见testing-progress.md本轮发布验收节。