2. 基本概念：租户(Tenant)、蓝图(Blueprint)、控制平面(Control Plane)的定义与关系

在深入探讨控制平面接口的数据传输设计之前，必须首先厘清三个核心抽象概念：租户、蓝图与控制平面。这三者构成了云原生平台中资源隔离、配置分发与生命周期管理的基石。理解它们的定义与相互关系，是后续章节中分析接口语义、数据流与一致性模型的前提。

2.1 租户 (Tenant)

租户是平台中逻辑隔离的最小自治单元，代表一组共享同一资源配额、访问策略与配置边界的使用者或业务系统。在云原生架构中，租户可以是一个部门、一个项目组、一个外部客户，甚至是一个微服务集群。

2.2 蓝图 (Blueprint)

蓝图是描述目标部署状态的声明式配置模板。它定义了租户内一组资源（如工作负载、网络策略、存储卷、中间件实例）的期望规格、依赖关系与版本约束。蓝图是“期望状态”的载体，控制平面通过比对蓝图与实际运行状态来驱动数据同步与升级。

• 结构组成： 蓝图通常包含资源清单（Manifest）、参数化变量（Parameters）、依赖图（DAG）与版本元数据（Version）。
• 不可变性： 每次升级都生成新的蓝图版本，旧版本保留用于回滚与审计。
• 租户绑定： 一个蓝图实例总是归属于某个租户，但蓝图模板可以在租户间共享（通过模板市场或 GitOps 仓库）。

# 简化版蓝图 YAML 结构示例
apiVersion: blueprint.controlplane.io/v1
kind: TenantBlueprint
metadata:
  tenant_id: "tenant-abc-123"
  blueprint_id: "bp-webapp-v2"
spec:
  version: "2.0.0"
  resources:
    - kind: Deployment
      name: web-frontend
      replicas: 3
      image: "registry.example.com/webapp:2.0.0"
    - kind: Service
      name: web-svc
      ports:
        - port: 80
          targetPort: 8080
  dependencies:
    - from: web-frontend
      to: redis-cache
  parameters:
    replicas: 3
    logLevel: "info"

2.3 控制平面 (Control Plane)

控制平面是负责接收、校验、存储并分发蓝图数据的核心系统组件。它不直接处理业务流量，而是作为“配置大脑”持续协调租户的期望状态与运行时状态。控制平面通过一组标准化的 API 接口与数据面（Data Plane）或代理（Agent）进行通信。

2.4 三者关系：从蓝图到租户的闭环

租户、蓝图与控制平面之间的关系可以概括为：控制平面以租户为隔离边界，以蓝图为数据载体，驱动租户内资源的持续升级与合规。 下图展示了这一核心关系架构：

2.5 关系总结矩阵

下表从数据流、生命周期与接口设计三个视角，总结三者的核心关系：