From 2e40d91391496b1cd672cabaa91635c91fc64455 Mon Sep 17 00:00:00 2001 From: ouyangxq <775153912@qq.com> Date: Fri, 23 Oct 2026 15:25:46 +0800 Subject: [PATCH] docs(deploy): require static PDA H5 hosting in test and gray --- 测试环境Jenkins部署指南.md | 2 +- 测试环境单机部署与配置契约.md | 7 +++++++ 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/测试环境Jenkins部署指南.md b/测试环境Jenkins部署指南.md index bd548c3..c75786a 100644 --- a/测试环境Jenkins部署指南.md +++ b/测试环境Jenkins部署指南.md @@ -44,7 +44,7 @@ 所有服务使用同一Nacos Namespace ID/Group、Redis DB与会话前缀。Auth独占签名私钥；JWKS和内部会话验证共用Auth。EVENT_OPERATIONS_TOKEN独立于内部业务令牌，留空禁用运维操作。现有文件卷和非桥业务MQ保留，topic/group使用test-前缀。 -Admin与Client各自Compose项目共接后端网络，发布必须给出CLIENT_WEB_URL/VITE_ADMIN_WEB_ORIGIN；两个PDA保留独立产物及仓绑定。域名、Namespace ID、MQ范围、数据卷和主机容量必须据实际清单核实，不能用模板默认值充当验收。 +Admin与Client各自Compose项目共接后端网络，发布必须给出CLIENT_WEB_URL/VITE_ADMIN_WEB_ORIGIN；两个PDA保留独立产物及仓绑定，H5 直接上传宿主机 Nginx 站点，不纳入容器或 Jenkins 镜像发布；执行方式以[部署契约](测试环境单机部署与配置契约.md)的“PDA H5 发布方式”为准。域名、Namespace ID、MQ范围、数据卷和主机容量必须据实际清单核实，不能用模板默认值充当验收。 ## 发布与验收 diff --git a/测试环境单机部署与配置契约.md b/测试环境单机部署与配置契约.md index e01795b..432874c 100644 --- a/测试环境单机部署与配置契约.md +++ b/测试环境单机部署与配置契约.md @@ -1,5 +1,12 @@ # 测试环境单机部署与配置契约 +## PDA H5 发布方式（2026-10-23 当前约束） + +- 国内、海外 PDA H5 在 TEST 与既有灰度统一采用宿主机 Nginx/宝塔站点直接托管构建产物。两端独立根目录，`location /` 读取上传的静态文件；`/gateway-api/` 独立转发当前环境统一 Gateway `/api/`。PDA H5 不再作为容器发布单元，不构建、恢复或发布旧 H5 镜像/Compose 服务；Admin、Client 与后端发布方式不受本条影响。 +- 两端产物路径和操作步骤分别见 `apps/pda-uniapp/README.md`、`apps/pda-overseas-uniapp/README.md`；站点配置以实际 `nginx -T` 展开的文件为准，保留 HTTPS、证书及面板 include。先上传资源，再替换首页，核对线上响应与构建产物摘要；首页健康不替代 API 和页面验收。 +- 用户本轮已删除灰度旧 PDA 容器，并按本轮提供的命令把两站点页面代理改回静态文件；用户回传国内、海外域名首页均 HTTP 200，并确认恢复。该结果不外推 TEST 容器清理、其他代理节点或完整业务验证；本轮未远程执行其他环境删除或发布。 +- 2026-09-29 起的 TEST H5 容器方案、2026-10-07 灰度容器/端口转发及后续镜像更新记录仅证明当时部署事实，已被本节发布方式取代。历史 `reports/gray-release-20261007/`、`reports/three-module-gray-20261012/` 等脚本与报告只用于追溯，不得重跑以恢复 PDA 容器或覆盖站点路由。 + ## 灰度发布后验收要求 - 用户于 2026-10-23 明确：每次灰度发布完成后，必须在实际部署的新版本上重新执行灰度验收脚本，不能复用上一版本真实 HTTP 结果代替发布后验收。发布前单测、构建与健康检查，以及局部接口烟测不能替代该步骤。