2026-09-29 18:47:37 +08:00
|
|
|
# TEST 单机部署执行清单
|
|
|
|
|
|
2026-09-29 23:54:02 +08:00
|
|
|
本清单定义部署顺序与门禁。单 TEST 统一架构现已部署，13 个保留服务与双 PDA H5 已检查健康；真实 HTTP 与目标事件故障恢复通过，页面核心流程及其余验收缺口仍未全部关闭。唯一入口：`docker-compose.yml`、`service-map.yml`、`env/.env.test.example` 与 `../config/nacos/test/`。正式规则见外层 `docs/测试环境单机部署与配置契约.md`、`docs/统一认证与服务通信契约.md`。
|
2026-09-29 18:47:37 +08:00
|
|
|
|
|
|
|
|
## 发布前清单
|
|
|
|
|
|
|
|
|
|
1. 记录13个服务镜像 tag/digest、后端和四端版本、SQL基线及14个Nacos配置版本。统一服务集合：Gateway/Auth/IAM/Order/Firstleg/Finance/Warehouse/Warehouse Overseas/Lastleg/File/Print/Audit/Integration。不存在单独海外Gateway或事件桥发布项。
|
|
|
|
|
2. 人工核对实际Nacos Namespace ID、Group、主机容量、文件卷UID 10001读写权限、MySQL各Schema、Redis DB/会话前缀、现有MQ topic/group。环境模板的Schema名只是待核基线，不能据此重命名运行库。
|
|
|
|
|
3. 所有容器共用 firstleg-test-network，并接外部 INFRA_NETWORK（默认 firstleg-test-infra-network）。中间件运行在宿主机时使用 host.docker.internal；运行在容器时用同网络服务名。禁止跨容器 localhost。Nacos应用名不等于Docker服务名，Auth HTTP地址使用 auth:9100。
|
|
|
|
|
4. Gateway仅向宿主机127.0.0.1发布9000（可配置GATEWAY_PUBLISHED_PORT）。同网络Nginx转发 gateway:9000；其余业务仅内部expose。不可把内部API端口直接发布给用户。
|
|
|
|
|
5. Auth私钥JWT_RSA_JWK_SET与JWT_CURRENT_KID由密钥凭据提供；所有服务共用JWT_JWKS_URI、Redis会话和内部服务令牌。EVENT_OPERATIONS_TOKEN与业务令牌分离，仅三家事件生产服务注入；为空禁用运维操作。禁止把真实env提交到仓库。
|
|
|
|
|
6. 本地Node合同、后端编译/测试及前端门禁完成后才能安排部署。Jenkins总控 backend-java，下游 baiyue-firstleg-<module>，构建节点java-builder，唯一部署节点java-test，凭据firstleg-test-env。旧dev/prod Job必须停用或改回其独立受维护版本，不得指向此TEST流水线；不对既有实际生产环境做改名、删除或部署。
|
|
|
|
|
|
|
|
|
|
## 停机切换
|
|
|
|
|
|
|
|
|
|
停止验收与业务写入并记录当前容器、网络、配置、卷、会话和消息对象。逐项取得部署、SQL和删除授权；本清单不授权执行。
|
|
|
|
|
|
|
|
|
|
先关闭旧写入、Relay和消费进程，再应用审核通过的服务SQL基线、统一Nacos和Compose配置。不执行整机清空Redis/MQ/文件，不删除业务Schema。业务MQ继续保留：文件导出、通知、审计启用参数按现有业务核实，test-前缀隔离；可靠审计可显式叠加docker-compose.audit.yml。文件卷持续挂载/data/files。
|
|
|
|
|
|
|
|
|
|
启动原则：中间件健康 → IAM/Auth和公共能力 → 业务消费者/生产者 → Gateway → 四端。Compose不创建循环depends_on；对每个服务以镜像HEALTHCHECK及真实消费者探针确认就绪后才开放写入。所有服务关闭自动SQL初始化，SQL必须单独审核执行。
|
|
|
|
|
|
|
|
|
|
执行入口deploy-built-service.sh仅接受test与13个保留服务，必须在目标服务器本机执行（TARGET_IS_LOCAL=true）；缺失关键环境参数、没有HEALTHCHECK、异常退出、健康超时均失败。deploy-services.sh仅顺序调用此入口，任何失败停止后续服务。构建和部署仍由明确授权启动。
|
|
|
|
|
|
|
|
|
|
统一登录、撤销、客户隔离、仓绑定、文件和资源查询通过后，新造装柜→尾程、资金指令→结果回传数据。完成正式契约全链路与故障恢复矩阵前不得宣称环境跑通。
|
|
|
|
|
|
|
|
|
|
旧海外网关/两区桥退出目标清单不代表已停机。只有直接消费、可靠重试/DEAD治理、认证撤销及四端切换验证通过，且确认无旧调用，才能按明确对象清单退役旧容器、注册和专用配置。禁止提前停止现有线上桥。
|
|
|
|
|
|
|
|
|
|
## 失败恢复
|
|
|
|
|
|
|
|
|
|
架构/Schema不匹配时默认停写、保留证据，修复后发布完整匹配新版本。确需恢复旧测试工作时，由人工按记录整体恢复旧镜像、四端、Nacos/Compose和旧Schema基线；不混跑两套协议。
|
|
|
|
|
|
|
|
|
|
单服务自动回滚默认关闭。仅确认前后版本协议和Schema完全一致时，才能在单服务Jenkins勾选ALLOW_SAME_CONTRACT_ROLLBACK；失败只允许恢复同仓库同服务前一镜像，回滚成功仍将Job判为失败。首次部署、旧镜像不属于该服务或旧新镜像相同均拒绝回滚。
|
|
|
|
|
|
|
|
|
|
## 本地验证入口
|
|
|
|
|
|
|
|
|
|
`node --test scripts/java-topology-contract.test.mjs scripts/overseas-deployment-contract.test.mjs scripts/deploy-built-service-rollback.test.mjs scripts/finance-deployment-contract.test.mjs scripts/audit-deployment-contract.test.mjs`
|
|
|
|
|
|
|
|
|
|
PowerShell Nacos发布DryRun只列待发布项，不联网；Shell/Groovy离线合同不能替代真实Jenkins语法校验、Docker Compose渲染、镜像启动或HTTP验收。
|
|
|
|
|
|
|
|
|
|
四端协作确认：Admin/Client各自使用firstleg-test-admin-web与firstleg-test-client-web Compose项目，共接external firstleg-test-network；默认API_UPSTREAM=http://gateway:9000，页面仅绑定127.0.0.1:9001/9002。发布必须提供CLIENT_WEB_URL与VITE_ADMIN_WEB_ORIGIN，不能猜测运行域名。两个PDA保留独立产物，共用统一入口。
|
|
|
|
|
|
|
|
|
|
SQL初始化脚本只接受两份显式传入、已审核的空库baseline路径；未设置ALLOW_TEST_SCHEMA_INITIALIZATION=true与明确TEST_MYSQL_CONTAINER时拒绝。它不检查或创建授权，不允许用于已有数据环境，不自动清库，第一份失败立即停止。两份基线的当前维护入口为deploy/sql/README.md；实际SQL执行仍由独立授权覆盖。
|
