3. 集群蓝图总览：多租户集群的整体架构图、控制面与数据面分离、租户生命周期管理

本章是整门课程的架构总纲。我们将从全局视角出发，绘制多租户隔离集群的完整蓝图，明确控制面与数据面的职责边界，并梳理租户从创建到销毁的完整生命周期。理解这张蓝图，是后续所有分层设计与技术选型的基础。

3.1 多租户集群整体架构图

下图展示了多租户隔离集群的核心组件与交互关系。整个系统遵循“控制面-数据面”分离原则，租户仅能感知到属于自己的隔离资源。

3.2 控制面与数据面分离

控制面与数据面的分离是多租户集群设计的基石。这种分离不仅带来了安全收益，也使得控制面的扩展与数据面的弹性伸缩可以独立进行。

3.3 租户生命周期管理

租户的生命周期管理是平台自动化的核心。一个完整的租户生命周期包含以下五个阶段，每个阶段都有对应的自动化操作与校验点。

3.4 租户生命周期管理的关键操作清单

下表列出了每个生命周期阶段中，平台需要执行的具体操作与校验点，供架构设计与自动化脚本开发参考。

3.5 多租户控制器核心逻辑

多租户控制器是控制面的核心扩展组件，它监听租户 CRD 的变化，并自动执行生命周期操作。以下是一个简化的控制器工作流程伪代码：

// 多租户控制器核心逻辑（伪代码）
func (c *MultiTenantController) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error) {
    tenant := &multitenancyv1.Tenant{}
    if err := c.Get(ctx, req.NamespacedName, tenant); err != nil {
        return ctrl.Result{}, client.IgnoreNotFound(err)
    }

    switch tenant.Status.Phase {
    case "Pending":
        // 1. 创建 Namespace
        ns := buildNamespace(tenant)
        if err := c.Create(ctx, ns); err != nil { return ctrl.Result{}, err }

        // 2. 创建 ResourceQuota
        rq := buildResourceQuota(tenant)
        if err := c.Create(ctx, rq); err != nil { return ctrl.Result{}, err }

        // 3. 更新状态为 "Initializing"
        tenant.Status.Phase = "Initializing"
        c.Status().Update(ctx, tenant)

    case "Initializing":
        // 4. 绑定 RBAC
        roleBinding := buildRoleBinding(tenant)
        if err := c.Create(ctx, roleBinding); err != nil { return ctrl.Result{}, err }

        // 5. 下发 NetworkPolicy
        netPol := buildDefaultNetworkPolicy(tenant)
        if err := c.Create(ctx, netPol); err != nil { return ctrl.Result{}, err }

        // 6. 更新状态为 "Active"
        tenant.Status.Phase = "Active"
        c.Status().Update(ctx, tenant)

    case "Terminating":
        // 7. 删除 Namespace（级联删除所有资源）
        ns := &corev1.Namespace{ObjectMeta: metav1.ObjectMeta{Name: tenant.Spec.Namespace}}
        if err := c.Delete(ctx, ns); err != nil { return ctrl.Result{}, err }

        // 8. 更新状态为 "Deleted"
        tenant.Status.Phase = "Deleted"
        c.Status().Update(ctx, tenant)
    }
    return ctrl.Result{}, nil
}