open-source/qinglong
1
0
Fork 0
mirror of https://github.com/whyour/qinglong.git synced 2026-09-20 16:07:11 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs(ql3): record exact cutover alpha milestone

Browse Source
This commit is contained in:
whyour
2026-08-31 02:15:30 +08:00
parent 79045a0d43
commit 50e6742b72
6 changed files with 23 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/adr/ADR-0522-content-bound-offline-docker-adopted-target.md
+3 -5
View File
@@ -1,6 +1,6 @@
# ADR-0522：内容绑定的离线 Docker Adopted Target
- 状态：Accepted（D-426b 源码候选；阶段实物尚未闭合）
- 状态：Accepted（D-426b 权威已由 D-426b2b 双架构阶段实物闭合）
- 日期：2026-08-30
- 决策：D-426b1
@@ -24,10 +24,8 @@ adopted bundle 增加 `docker-target` service kind，生成 `service/docker-targ
## 阶段实物门
本 ADR 当前只是源码候选，不得称为已交付的 D-426b 阶段实物。只有后续同源原生 amd64/arm64 artifact job 在将要上传的 exact Trial Kit 上完成受认证 transform/apply、生成并验证 `docker-target.json`、真实 target start/stop，并得到 clean `rollback_candidate`，再由 bundle/milestone auditor 闭合，才能把状态升级为“阶段实物已交付”。
在此之前，用户可继续使用 D-426a 的 `upgrade-rehearsal.sh` 完成 read-only legacy + side-by-side stage；不得从本 ADR 推导生产切换授权。
D-426b2b 已在提交 `79045a0d439074994812d9cd682f933b9e415706` 的原生 amd64/arm64 artifact [run 33326143744](https://github.com/whyour/qinglong/actions/runs/33326143744) 上，从将要上传的 exact Trial Kit 完成受认证 transform/apply、生成并验证 `docker-target.json`、真实 legacy stop、只读 target probe start/stop与 clean `rollback_candidate`，再由 bundle/milestone auditor 闭合。因此本 ADR 的离线 image authority 已进入阶段实物，但不得从中推导生产切换或 Public Release 授权。
## 后续
D-426b2 接入受认证 transform/apply、descriptor 消费、真实 target start/stop 与 clean rollback candidate；D-426c 处理 target 写入后的 `reconciliation_required`。Public prerelease/release 仍需维护者显式授权。
D-426c 处理 target 接受业务写入后的 `reconciliation_required`。Public prerelease/release 仍需维护者显式授权。
docs/adr/ADR-0523-post-apply-adopted-target-baseline.md
+4 -4
View File
@@ -1,6 +1,6 @@
# ADR-0523：Apply 后的 Adopted Target 启动前基线
- 状态：Accepted（D-426b2a 源码候选；阶段实物尚未闭合）
- 状态：Accepted（D-426b2a 基线已由 D-426b2b 双架构阶段实物闭合）
- 日期：2026-08-30
- 决策：D-426b2a
@@ -35,7 +35,7 @@ target controller 同时接受原有 Application v3 与 adopted Application v4
## 阶段实物门
本 ADR 只闭合此前不合理的 rollback 语义，仍不是新的可下载 Trial Kit。D-426a 双架构 headless bundle 仍是当前可交付的升级阶段实物。只有同源原生 amd64/arm64 artifact job 在将要上传的 exact bundle 上完成：
本 ADR 的 rollback 语义已由 D-426b2b 新的可下载 Trial Kit 闭合。同源原生 amd64/arm64 artifact job 已在将要上传的 exact bundle 上完成：
1. reviewed stage/verify；
2. versioned transform/verify；
@@ -45,8 +45,8 @@ target controller 同时接受原有 Application v3 与 adopted Application v4
6. v4 baseline 绑定且最终为 clean `rollback_candidate`；
7. bundle 与 milestone 离线审计；
才能把 D-426b2 升级为阶段实物。任何一步只在仓库测试 fixture 中通过都不能替代 exact 上传包演练。
提交 `79045a0d439074994812d9cd682f933b9e415706` 的显式 Local headless [run 33326143744](https://github.com/whyour/qinglong/actions/runs/33326143744) 对以上七项全部通过，两个 bundle 与 milestone 下载后再次离线审计为 `compatible=true`。任何后续变更仍不能用仓库 fixture 替代 exact 上传包演练。
## 后续
D-426b2b 实现并审计上述 exact bundle 用户旅程，随后显式生成新的双架构 artifact。D-426c 继续处理 target 产生业务写入后的 capture、review、reconciliation 与恢复。
D-426c 继续处理 target 产生业务写入后的 capture、review、reconciliation 与恢复。
docs/adr/ADR-0524-exact-headless-upgrade-cutover-rehearsal.md
+4 -2
View File
@@ -1,6 +1,6 @@
# ADR-0524：Exact Headless 升级切换链演练
- 状态：Accepted（D-426b2b 源码候选；双架构阶段实物待本次 artifact run）
- 状态：Accepted（D-426b2b 同源双架构阶段实物已交付）
- 日期：2026-08-30
- 决策：D-426b2b
- 关联：ADR-0520、ADR-0521、ADR-0522、ADR-0523
@@ -42,7 +42,9 @@ ADR-0523 已修正 Apply 后 Adopted Target 的回退基线，但仓库内单元
- package boundary 保持 18 个 workspace package、无 single/shallow package、零 finding；
- Operator image、milestone workflow、Stage Index workflow auditor 均为 compatible。
真实镜像构建、固定 Docker CLI、双架构 exact rehearsal 和新 artifact 摘要将在本提交的 GitHub artifact run 中补充。只有该 run 成功后，才把状态更新为“阶段实物已闭合”。
提交 `79045a0d439074994812d9cd682f933b9e415706` 的显式 Local headless [run 33326143744](https://github.com/whyour/qinglong/actions/runs/33326143744) 已完成 `42 success / 2 expected scope skip / 0 fail`。两个原生架构都从将要上传的 exact Trial Kit 实跑 readiness、reviewed stage、Owner credential presentation、transform/apply、真实 Docker legacy stop、只读 target cutover probe start/stop，并得到 clean `rollback_candidate`；普通 Application 启动命令不能冒充 probe。最终器生成同 run 的 milestone v5，三个 artifact ID 为 amd64 `9736356778`、arm64 `9736354298`、milestone `9736502478`，保留至 2026-09-29。
下载后的 milestone 与两个 Trial Kit 已再次用仓库离线 auditor 审计，三者均返回 `compatible=true`。Docker archive 为 amd64 `226122240` bytes / `sha256:1e1c5c83fd2c39b3bbe7b194113998a96cbe810e69d34858c3f40d2638837c60`，arm64 `221521920` bytes / `sha256:dcec37f65382d7d8c06f448780878ec2474e45d6e64b2febb764b1836898d2d6`；两个 verification v6 都把 `legacyUpgradeReadiness`、`legacyUpgradeStage`、`legacyUpgradeCutover` 标记为 `passed`。同 run 的跨架构资源证据还在 128 MiB、0.5 CPU、64 PID 的 CI stress envelope 下记录 x64 `77967360` bytes、arm64 `72581120` bytes peak，并明确该数据不是固定物理设备最低配置承诺。
## 后续
docs/adr/README.md
+3 -3
View File
@@ -525,9 +525,9 @@
| [ADR-0519](./ADR-0519-local-console-secret-backed-automation.md) | Local Console Secret-backed 自动化 | Accepted（D-424 双架构 milestone 已交付） |
| [ADR-0520](./ADR-0520-downloadable-local-legacy-upgrade-readiness.md) | 可下载的 Local Legacy 升级就绪盘点 | Accepted（D-425 双架构 Alpha 实物已交付） |
| [ADR-0521](./ADR-0521-reviewed-side-by-side-local-upgrade-stage.md) | 受审核计划驱动的 Local Side-by-side 升级暂存 | Accepted（D-426a 双架构 Alpha 实物已交付） |
| [ADR-0522](./ADR-0522-content-bound-offline-docker-adopted-target.md) | 内容绑定的离线 Docker Adopted Target | Accepted（D-426b 源码候选；阶段实物尚未闭合） |
| [ADR-0523](./ADR-0523-post-apply-adopted-target-baseline.md) | Apply 后的 Adopted Target 启动前基线 | Accepted（D-426b2a 源码候选；阶段实物尚未闭合） |
| [ADR-0524](./ADR-0524-exact-headless-upgrade-cutover-rehearsal.md) | Exact Headless 升级切换链演练 | Accepted（D-426b2b 源码候选；双架构阶段实物待闭合） |
| [ADR-0522](./ADR-0522-content-bound-offline-docker-adopted-target.md) | 内容绑定的离线 Docker Adopted Target | Accepted（D-426b 权威已由 D-426b2b 双架构实物闭合） |
| [ADR-0523](./ADR-0523-post-apply-adopted-target-baseline.md) | Apply 后的 Adopted Target 启动前基线 | Accepted（D-426b2a 基线已由 D-426b2b 双架构实物闭合） |
| [ADR-0524](./ADR-0524-exact-headless-upgrade-cutover-rehearsal.md) | Exact Headless 升级切换链演练 | Accepted（D-426b2b 双架构阶段实物已交付） |
## 规则