4. 集群模板蓝图定义：什么是集群模板蓝图、蓝图版本化、蓝图与 Helm Chart 的绑定关系

在云原生应用交付体系中，集群模板蓝图是连接基础设施配置与 Helm Chart 应用逻辑的核心抽象层。它定义了一个集群环境应具备的“期望状态”，包括节点规格、网络策略、存储类、附加组件以及预置的 Helm Release 清单。蓝图本身是版本化的，并与 OCI Registry 中的 Helm Chart 建立精确的绑定关系，从而为变更门禁和回滚判断提供可追溯的基准。

4.1 什么是集群模板蓝图

集群模板蓝图（Cluster Template Blueprint）是一份声明式文档，通常以 YAML 或 JSON 格式描述一个集群的完整配置模板。它包含以下关键域：

4.2 蓝图版本化

蓝图版本化是变更门禁的基石。每个蓝图版本对应一个不可变的快照，包含完整的配置和 Chart 绑定关系。版本号遵循语义化版本规范（SemVer），并存储在 OCI Registry 的 Artifact Manifest 中。

版本化流程如下：

1. 创建/修改蓝图：编辑 YAML 定义，更新 Chart 版本或基础设施参数。
2. 版本提升：通过 CI Pipeline 自动计算下一个版本号（major/minor/patch）。
3. 签名与推送：使用 Cosign 对蓝图内容签名，推送至 OCI Registry 的 blueprint 仓库。
4. 不可变标记：Registry 开启不可变标签策略，禁止覆盖已发布的版本。

# 蓝图版本示例：oci://registry.io/blueprints/prod-cluster:v1.2.0
# 包含的 Chart 绑定：
#   - oci://registry.io/charts/redis:7.2.0
#   - oci://registry.io/charts/nginx-ingress:4.8.0
#   - oci://registry.io/charts/prometheus:25.0.0

4.3 蓝图与 Helm Chart 的绑定关系

蓝图通过 OCI 引用（OCI Reference） 与 Helm Chart 建立精确绑定。绑定关系包含三个层级：

• Chart 仓库地址：指向 OCI Registry 中的 Chart 仓库。
• Chart 版本：精确的 SemVer 版本，支持 ^ 或 ~ 范围约束。
• Chart 摘要（Digest）：可选，用于不可变绑定，确保每次部署使用完全相同的 Chart 内容。

4.4 蓝图与 Helm Chart 绑定关系架构图

下图展示了蓝图版本化后，如何通过 OCI Registry 与多个 Helm Chart 建立绑定，并最终交付至目标集群：

4.5 蓝图变更门禁与回滚判断流程

基于蓝图版本化和绑定关系，变更门禁与回滚判断遵循以下步骤：

1. 提交变更请求：用户提交新蓝图版本（如 v1.3.0），包含更新的 Chart 版本或基础设施参数。
2. 门禁检查：系统对比新蓝图与当前部署蓝图的差异，包括：
   • Chart 版本变化（major/minor/patch）
   • Chart Digest 变化（即使版本号不变）
   • 基础设施配置变化（节点数、存储类等）
3. 自动回滚判断：若门禁检查失败（如 Digest 不匹配或 major 版本升级未审批），系统自动触发回滚至上一已知良好的蓝图版本（如 v1.2.0）。
4. 回滚执行：从 OCI Registry 拉取 v1.2.0 的蓝图及其绑定的 Chart Digest，重新部署集群。