qinglong/docs/operations/ql3-cluster-alpha-milestone.md

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 时可离线复审：

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 证明。