Cluster API 架构与设计思路分析

原文：raw/cluster-api-architecture-analysis.md · 仓库：https://github.com/kubernetes-sigs/cluster-api · 优先级 P0

一句话定位

Cluster API 用声明式 API 管理 Kubernetes 集群生命周期，把 Cluster/Machine/MachineDeployment 和 provider infra/bootstrap/control-plane 拆成可组合控制器。

核心架构图

┌────────────────────────────────────────────────────────────────────────────┐
│ Declarative cluster lifecycle intent                                       │
│ Platform teams describe desired workload clusters and machines.            │
└────────────────────────────────────────────────────────────────────────────┘
                                       │
                                       ▼
┌────────────────────────────────────────────────────────────────────────────┐
│ Cluster API core                                                           │
│ Cluster, Machine, MachineDeployment, MachineSet, and related lifecycle     │
│ controllers.                                                               │
└────────────────────────────────────────────────────────────────────────────┘
                                       │
                                       ▼
┌────────────────────────────────────────────────────────────────────────────┐
│ Provider contracts                                                         │
│ Infrastructure, bootstrap, and control-plane providers implement           │
│ environment details.                                                       │
└────────────────────────────────────────────────────────────────────────────┘
                                       │
                                       ▼
┌────────────────────────────────────────────────────────────────────────────┐
│ Output                                                                     │
│ A management cluster continuously reconciles workload clusters and         │
│ machines.                                                                  │
└────────────────────────────────────────────────────────────────────────────┘

模块分层

关键数据流

用户声明 Cluster/Machine topology
        │
        ▼
CAPI core controller 协调对象
        │
        ▼
provider controller 创建云/裸金属资源
        │
        ▼
bootstrap/control-plane provider 初始化节点
        │
        ▼
状态回写并支持升级/迁移

设计决策与哲学

• 补齐 集群生命周期 维度：Cluster API 让当前 wiki 不只停留在 serving engine 或单个 operator，而能解释 Kubernetes 平台里的相邻控制面。
• 边界判断：Kubespray 偏 Ansible 部署；Cluster API 偏 Kubernetes-native 声明式集群生命周期。
• 选型价值：它应和 kubernetes, cloud-native-security 一起看，而不是孤立评估。