mirror of
https://github.com/whyour/qinglong.git
synced 2026-09-20 16:07:11 +08:00
44 lines
2.9 KiB
Markdown
44 lines
2.9 KiB
Markdown
# QingLong 3.0 Cluster Alpha Integration Milestone
|
||
|
||
本目录是一次完整 Cluster Alpha integration milestone 的闭合索引，不包含八个大体积 Docker archive。`manifest.json` 精确列出同一次 GitHub Actions run 生成并离线复核的 control、control-ai、admin、worker 在 amd64、arm64 上的八个 artifact。只有该索引和目标 artifact 同时存在，才可把这次运行称为阶段性 Cluster 集成产物。
|
||
|
||
## 成熟度边界
|
||
|
||
- `maturity` 固定为 `cluster_integration_candidate_not_public_release`；
|
||
- 适用于隔离 registry、临时 Kubernetes/K3s 节点和非生产数据库上的集成验证；
|
||
- 不提供公开 GHCR tag、不可变 catalog selection、Cosign 签名、GitHub attestation、生产 HA、升级或长期支持承诺；
|
||
- 低配路由器/NAS 应选择 Local Alpha Trial Kit，不能部署四个 Cluster 角色。
|
||
|
||
任何单角色或单架构 artifact 提前上传都只是中间文件。缺少 `ql3-alpha-<sourceRevision>-cluster-milestone`、完整 CI 未成功、run/attempt 不一致或索引审计失败时，不得作为阶段交付物。
|
||
|
||
## 选择并验证下载物
|
||
|
||
1. 在本目录执行 `sha256sum --check SHA256SUMS`。
|
||
2. 确认 `manifest.json`：
|
||
- schema 为 `qinglong/alpha-cluster-milestone@v1`；
|
||
- `sourceRevision` 为目标完整 40 位提交；
|
||
- workflow event/job 为 `workflow_dispatch` / `cluster-alpha-milestone`；
|
||
- 对应 run ID/attempt 的完整 `QingLong 3.0 CI` 成功；
|
||
- `artifacts` 恰好包含四角色乘两架构的八项。
|
||
3. 按节点架构和需要的角色下载 artifact；一个可运行的完整 Cluster 测试部署通常需要 control、admin、worker，启用 AI 才增加 control-ai。
|
||
4. 对每个 bundle 执行其 `SHA256SUMS`，并核对 bundle `manifest.json` 的 digest 等于 milestone `bundleManifest.sha256`。
|
||
5. 使用隔离 registry 导入 Docker archive，再以导入后的 immutable digest 更新测试 deployment lock；不要直接依赖 archive 内的 `ci-*` tag。
|
||
|
||
持有同版本源码与 Node.js 24 时可离线复审：
|
||
|
||
```sh
|
||
node scripts/ql3-cluster-alpha-milestone.cjs \
|
||
--mode=audit \
|
||
--milestone=/absolute/path/to/ql3-alpha-cluster-milestone
|
||
|
||
node scripts/ql3-cluster-alpha-bundle.cjs \
|
||
--mode=offline-audit \
|
||
--bundle=/absolute/path/to/one-cluster-bundle
|
||
```
|
||
|
||
这两个命令不访问 Docker 或网络；它们验证闭合文件集、长度、SHA-256、SBOM identity、workflow evidence、角色/架构集合和八个主体互不复用。它们不会重新执行漏洞扫描或 Kubernetes live gate。
|
||
|
||
## 部署与回退
|
||
|
||
Cluster candidate 只应进入临时命名空间、隔离 registry 和可删除数据库。回退方式是删除测试 workload 与测试数据、撤销临时 credential，并回到原 deployment lock。生产 CloudNativePG、跨主机 STONITH/DR、CSI custody、外部 ingress TLS/IdP 和正式升级仍必须由 Public Release Set 的 catalog-bound deployment ceremony 证明。
|