openFuyao技术讲堂 | Cluster API安装指导

王娜、徐尤红2026-04-07

01 Cluster API简介

Cluster API是一个Kubernetes子项目,通过声明式API和控制器模式实现Kubernetes集群的生命周期管理自动化。

  • 基础设施即代码:使用Kubernetes自定义资源定义集群配置。
  • 声明式管理:通过YAML文件描述期望的集群状态。
  • 控制器模式:自动协调实际状态与期望状态。

02 安装流程

2.1 安装流程图

第2期图1

2.2 安装须知

2.2.1 操作系统

表1 支持操作系统信息

操作系统发行版本内核版本架构
openEuler20.034.19.*ARM64、x86_64
openEuler22.035.10.*ARM64、x86_64
openEuler24.036.6.*ARM64、x86_64
Ubuntu22.045.15.*ARM64、x86_64

2.2.2 Kubernetes版本

  • kube-apiserver:v1.34.3
  • kube-controller-manager:v1.34.3
  • kube-scheduler:v1.34.3
  • etcd:v3.6.7
  • kube-proxy:v1.34.3
  • kubelet:v1.34.3
  • kubectl:v1.34.3
  • containerd:v2.1.1

2.2.3 部署形态

  • 在线部署

    • 单节点部署(AIO)
    • 多节点部署
    • 高可用部署(HA,apiserver高可用部署)
  • 离线部署

    • 单节点部署(AIO)
    • 多节点部署
    • 高可用部署(HA,apiserver高可用部署)

2.2.4 部署工具

BKE工具将机器分为两种类型:引导节点和业务集群节点。

  • 引导节点:部署一个轻量级的K3s集群,作为长期引导集群,用于创建和管理目标业务集群,运行Cluster API的控制平面组件。
  • 业务集群节点:部署由Cluster API实际创建和管理的目标业务集群,用于运行用户工作负载。其生命周期由引导集群控制。

整体安装过程为在一台裸机上进行初始化配置和安装等操作,将其作为引导节点,在引导节点安装K3s轻量化集群,完成cluster-api、provider-bke以及openFuyao管理面。最后在openFuyao管理面上进行业务集群的安装、卸载、扩缩容、升级等操作。

安装过程中需要的用户名、密码、端口等信息,以及安装过程中的可选操作,请查看注意事项

2.3 安装包完整性校验

为确认安装包在传输过程中是否由于网络连接、存储设备、恶意攻击等原因出现数据不完整或遭到篡改的问题,在获取到安装包后,需要对安装包进行完整性校验,通过校验的安装包才能被部署。

在校验安装包完整性之前,需要准备openFuyao社区PGP公钥安装包文件sha256校验文件gpg签名文件,并按照操作指导完成文件完整性校验。

2.4 在线安装引导集群 / 离线安装引导集群

您可以选择在线或离线方式安装引导集群。

两种方式的硬件配置要求相同。

表1 最小化部署硬件配置

节点类型节点数量vCPU(个)内存(GB)硬盘
引导节点124系统盘≥100G
业务集群节点1816系统盘≥100G

表2 推荐硬件配置

节点类型节点数量vCPU(个)内存(GB) 硬盘
引导节点124系统盘≥100G
业务集群节点根据实际情况决定

两种安装方式的具体操作不同。您可以点击查看在线安装引导集群离线安装引导集群的环境准备和安装步骤。

2.5 管理面安装业务集群(推荐)

安装业务集群有两种方式:管理面安装或Linux后端安装。

推荐您使用管理面安装方式,界面操作简单直观、步骤少。

图1 openFuyao管理面-“集群生命周期管理”界面

第2期图2

您也可以尝试使用Linux后端安装方式

2.6 离线组件增量安装(可选)

在离线环境安装引导集群后,如果需要在业务集群中安装扩展组件,可以增量安装,无须重新制备离线包安装引导集群和业务集群。您可以点击查看环境准备安装步骤

本文由openFuyao社区首发,欢迎遵照CC-BY-SA 4.0协议规定转载。