4. 蓝图（Blueprint）概念：资源模板的核心
在基于资源模型的租户隔离体系中，蓝图（Blueprint） 是定义一组云原生资源及其关系的标准化模板。它抽象了租户环境的通用配置，使得运维人员可以通过参数化方式快速、一致地创建和升级租户隔离环境，而无需手动编排每个 Kubernetes 资源。
4.1 蓝图的核心作用
蓝图作为资源模板，承担以下关键职责：
- 资源编排模板化：将 Namespace、NetworkPolicy、ResourceQuota、LimitRange、RBAC 等资源封装为可复用的模板。
- 环境一致性保障：确保每个租户环境基于同一模板生成，消除配置漂移。
- 版本化演进：支持蓝图版本管理，实现隔离环境的可追溯升级与回滚。
- 参数化定制：通过蓝图参数，允许在模板化基础上为不同租户注入差异化配置。
故障排查视角： 在滚动升级故障中，蓝图版本不匹配或参数传递错误是导致租户隔离策略失效的常见根因。理解蓝图结构是定位此类问题的前提。
4.2 蓝图版本
蓝图版本是模板演进的快照，每个版本包含一组不可变的资源定义。版本管理是滚动升级的基础：
| 版本属性 | 说明 | 故障排查意义 |
|---|---|---|
| 版本号 | 语义化版本（如 v1.2.3），标识模板的迭代 | 升级时需确认目标版本与当前环境的兼容性 |
| 版本快照 | 发布后不可变，保证环境可追溯 | 回滚时直接引用历史版本快照，避免配置丢失 |
| 版本依赖 | 声明所依赖的基础蓝图或平台版本 | 依赖不满足会导致资源创建失败或策略冲突 |
| 变更日志 | 记录版本间的资源变更明细 | 快速定位升级后新增或删除的资源对象 |
最佳实践： 在滚动升级前，始终比对目标蓝图版本与当前运行版本的资源差异清单，避免因 NetworkPolicy 规则变更导致租户间非预期连通。
4.3 蓝图参数
蓝图参数允许在模板化基础上实现租户级定制，是连接通用模板与具体租户需求的桥梁。参数分为以下类型：
- 必填参数：如租户 ID、命名空间名称，每次实例化必须提供。
- 可选参数：如资源配额大小、网络策略白名单，提供默认值。
- 敏感参数：如数据库密码、TLS 证书，通过 Secret 引用，不在蓝图明文存储。
- 计算参数：基于其他参数动态生成，如根据租户等级自动计算 CPU 限制。
# 蓝图参数定义示例（YAML 片段）
parameters:
tenantId:
type: string
description: "租户唯一标识"
required: true
cpuLimit:
type: integer
description: "租户 CPU 配额上限"
default: 4
enableNetworkIsolation:
type: boolean
default: true
dbPasswordRef:
type: secret
description: "数据库密码的 Secret 引用"
required: true4.4 蓝图依赖关系
蓝图依赖关系定义了模板之间的层级与引用，确保资源创建顺序正确。依赖关系通常分为三类：
| 依赖类型 | 描述 | 示例 |
|---|---|---|
| 基础依赖 | 当前蓝图依赖另一个蓝图先被实例化 | 租户网络蓝图依赖集群基础网络蓝图 |
| 资源依赖 | 蓝图内某个资源依赖另一个资源先创建 | Deployment 依赖 ConfigMap 先就绪 |
| 数据依赖 | 当前蓝图需要上游蓝图的输出参数 | 监控蓝图需要租户蓝图的 Namespace 名称 |
滚动升级风险提示： 当升级涉及多个有依赖关系的蓝图时，必须按照依赖顺序逐层升级。例如，先升级基础网络蓝图，再升级租户网络蓝图，最后升级应用蓝图。违反依赖顺序可能导致资源创建失败或隔离策略断裂。
4.5 蓝图与滚动升级的关联
在滚动升级场景中，蓝图作为升级的“配置单元”，其版本、参数和依赖关系直接影响升级的成败：
- 版本选择：滚动升级的目标版本必须与当前运行版本兼容，避免资源定义冲突。
- 参数迁移：升级时需将旧版本的参数值正确映射到新版本参数，参数缺失或类型不匹配是常见故障。
- 依赖检查：升级前需验证所有依赖蓝图是否已升级到兼容版本，否则会导致级联故障。
- 回滚策略：基于蓝图版本快照，可以快速将整个租户环境回滚到上一个稳定版本。