feat(deploy): add guarded existing-ECS broker migration tooling

Discover the current Compose project and all override files from container
labels. Add read-only preflight plus prepare/check/build/activate/rollback
commands without editing the running .env, CA, database volumes or unrelated
services. Preserve heterogeneous application image identities for rollback.

Prepare a private keyring, independent router credential, pinned source
snapshot and additive connector/router overlay. Refuse key overwrite and
configuration/image drift. Build offline from the exact existing ARM64
runtime, smoke import and validate role settings through stdin-only inputs.
Require explicit v2 client readiness before activation and recreate only
connector/router with --no-deps. Document actual backup/image evidence,
current client limitation and token-lifecycle rollback boundaries.

Validation: 239 passed, 3 skipped (real PostgreSQL absent), 30 existing
dependency deprecation warnings. Add 26 mocked Docker policy tests; host
script parses as Python 3.7, CLI help/docs/diff checks pass. Docker policy
mocks are not actual Compose or ARM64 build validation.

No remote files, keys, credentials, containers or live configuration were
changed. Stage 5 operational acceptance remains pending actual ECS build,
real databases/platform, v2 client, key recovery and controlled rollout.
This commit is contained in:
ex_tianzy
2026-11-04 12:18:43 +08:00
parent d1ab834ecb
commit da1b4230b9
6 changed files with 778 additions and 1 deletions
+20 -1
View File
@@ -12,7 +12,7 @@
| 2 | 集中凭据Broker及刷新 | 应用/用户锁、持锁重读、版本CAS、响应校验、刷新unknown;新授权不受旧刷新覆盖 | 本次完成本地开发测试 |
| 3 | OAuth与认证领取 | 共享state事务、实际用户核验、绑定代次、只返回access的独立DTO及领取认证 | 本次完成本地开发测试,显式broker模式启用 |
| 4 | ECS权威解绑与消息任务关联 | 停发Token、失效事务/任务、连接和旧码联动,多实例/异常恢复 | 本次完成本地开发测试,broker模式生效 |
| 5 | 配置部署、迁移与旧接口退出 | 密钥挂载、产品权限配置、客户端对接、停用旧刷新/claim及代理、ARM64和真实平台验收 | 待开发 |
| 5 | 配置部署、迁移与旧接口退出 | 密钥挂载、产品权限配置、客户端对接、停用旧刷新/claim及代理、ARM64和真实平台验收 | 已交付现有部署准备/检查/构建/切换/回退工具;现机及客户端验收待执行 |
产品经理决定功能和Scope清单。阶段1不预设具体权限,不生成真实凭据、不读取现有设备、不调用平台。
@@ -151,3 +151,22 @@ Windows / Python 3.12.10,平台桩、临时证书/密钥、SQLite及带Lua的F
最后完整回归:**213 passed,3 skipped,30 warnings**(45.87秒)。3个跳过项均需要真实PostgreSQL连接,warnings为既有uvicorn/websockets旧API弃用提示(新增真实回环连接增加提示次数);relay模块AST、文档和diff检查通过。
生产部署、真实Redis/PostgreSQL多实例、ARM64镜像、平台实际撤权/Scope/容量和客户端安装升级仍待阶段5及现场验收。平台已接收的请求不可靠解绑撤回,已发access仍可能有效到期。
## 阶段5工具交付:保留现有部署的迁移接线(2026-11-04)
用户提供现场Docker/Compose、7份配置路径、不同组件镜像ID及已生成备份,数据库dump目录解析通过,并建立4个原镜像回滚标签。该信息仅是当次现场证据,不等同真实恢复或新架构上线验收。
新增标准库工具`scripts/broker_deploy.py`与[现有ECS操作指导](EXISTING_ECS_BROKER_DEPLOY.md):
- `preflight`只读识别实际容器标签、Compose文件、项目与ARM64镜像,不写文件/密钥,不输出解析配置,不重启。
- `prepare`创建运行目录外的新私有计划:保留全部原Compose、CA、数据库卷和异构镜像;生成独立keyring/准入Secret和仅影响connector/router的叠加,复制无凭据源代码快照。不修改现有.env或初始化数据库。
- `check`拒绝配置/源码/密钥/镜像漂移,核对原挂载、网络、数据库卷及内部路径拒绝规则;密钥权限/UID要求明确。不打印展开后的Secret。
- `build`复用确切现场ARM64运行镜像,以禁网/禁止拉取方式构建候选;不替换原镜像、不下载依赖。导入smoke与两角色配置/密钥读取检查通过后才标记候选就绪;配置通过stdin送入无网络临时容器,不放在命令行或日志。
- `activate`需明确声明v2客户端就绪,重新检查候选及运行基线后仅up connector/router;缺标志时在发切换命令前拒绝。健康通过后仍需实际业务验收。
- `rollback`有独立停用broker声明,按每组件原实际镜像回退connector/router,不恢复旧refresh或删除数据库。保持新密钥和凭据数据,避免覆盖平台已轮换状态。
默认部署配置不自动切换;本次工具通过本地模拟Docker编排测试,但开发机没有真实Docker/ARM64环境,不能宣称已构建或验证候选镜像。新客户端尚未适配,现机当前只应执行只读preflight或经产品权限确认的准备/构建,不能启用broker。
本地新增工具策略测试26项,覆盖7份配置保留、独立旧镜像、准备不启动服务、密钥不覆盖、路径/配置漂移、私有入口拒绝、产品权限格式、候选失败不标就绪、候选换标签拒绝、客户端就绪门槛、离线构建和仅重建两服务。最后完整回归:**239 passed,3 skipped,30 warnings**(46.94秒);跳过项需要真实PostgreSQL,warnings仍为旧依赖弃用提示。宿主脚本通过Python3.7语法兼容检查、CLI help及diff检查。
测试中Docker命令均为受控桩,不声称实际执行Compose合并、ARM64构建或密钥挂载。真实Compose/ARM64、PostgreSQL/Redis、多用户平台、客户端升级和密钥恢复仍待执行,因此阶段5总体尚未验收完成。