认识 openFuyao BKE:从集群安装到全生命周期管理

部署 Kubernetes 的难点,往往不在第一条 kubeadm init 命令,而在之后的一系列工作:节点初始化、容器运行时、网络插件、证书、高可用、离线制品,以及集群上线后的扩缩容和升级。

如果这些都靠一次性脚本串联,环境越多,脚本分支越多,集群之间的差异也越难追踪。

BKE 是 openFuyao 的安装部署工具,目标是让 Kubernetes 集群的创建和运维变得标准、可重复。它基于 Cluster API,将集群和节点抽象为 Kubernetes 资源,并结合 openFuyao 管理面,覆盖安装、卸载、扩缩容和升级等生命周期操作。

BKE 解决什么问题

BKE 不是另一个 Kubernetes 发行版,也不是用来替代业务应用编排的工具。它主要管理的是集群本身的生命周期。

它试图解决四类问题:

  • 降低部署门槛:把节点准备、组件安装和集群组装串成标准流程,减少重复劳动。
  • 让集群配置可声明:通过 BKECluster、BKENode 等自定义资源描述期望状态,而不是只保留一组执行过的命令。
  • 覆盖后续运维:集群创建不是终点,节点扩缩容、版本升级和集群卸载也走统一的管理路径。
  • 适应不同交付环境:同时提供在线与离线安装方式,并支持通过 Web 管理面或命令行操作。

对于需要反复搭建测试集群的开发者,BKE 可以减少环境准备时间;对于需要管理多个业务集群的平台团队,声明式 API 和统一管理面更有价值。

从一台机器到一个业务集群

BKE 的部署过程可以概括为“先建立管理入口,再创建目标集群”。

         Web 管理面 / kubectl / YAML
                    │
                    ▼
┌─────────────────────────────────────────┐
│ 引导集群(K3s)或高可用管理集群           │
│ Cluster API + cluster-api-provider-bke  │
└──────────────────┬──────────────────────┘
                   │ 持续调谐期望状态
      ┌────────────┴────────────┐
      ▼                         ▼
 BKECluster                  BKENode
集群期望状态                  节点期望状态
      │                         │
      ▼                         ▼
   业务集群               bkeagent(systemd)
                                │
                                ▼
                   节点初始化、组件安装与配置

1. 初始化引导节点

bke init 将一台机器初始化为引导节点,在其上部署轻量级 K3s 集群,再安装 Cluster API、cluster-api-provider-bke 和 openFuyao 管理面。

引导集群适合快速体验和创建小规模业务集群,但它本身不支持高可用。中大规模或长期运行的场景,应再部署高可用管理集群,由管理集群承接后续业务集群的生命周期管理。

2. 声明目标集群

用户可以通过 openFuyao 管理面填写集群配置,也可以使用 Kubernetes YAML 和命令行。BKECluster 描述集群的期望状态,BKENode 描述集群中的节点。

这些资源让集群配置有了明确的 API 载体,也为配置版本化、变更评审和自动化提供了基础。

3. 控制器与节点代理协同执行

Cluster API 提供声明式集群管理框架,cluster-api-provider-bke 是 openFuyao 实现的基础设施 Provider(基础设施提供者),负责解析相关资源并协调集群操作。

真正需要落到宿主机上的工作,由运行在各节点上的 bkeagent 执行。它以二进制方式运行并由 systemd 托管,监听 kube-apiserver 中的资源变化,完成节点初始化、组件安装和配置等任务。

这个分工很清晰:控制面负责“要做什么”,节点代理负责“如何在这台机器上完成”。

值得关注的能力

完整的集群生命周期

BKE 不只处理首次安装。业务集群的创建、卸载、扩缩容和升级,都可以从同一套管理体系进入。

以工作节点扩容为例,用户创建对应的 BKENode 资源后,控制器会在后台推进环境初始化、节点加入和健康检查,并通过资源状态暴露进度。相比登录节点逐台执行命令,这种方式更容易观察,也更适合自动化。

在线与离线两种交付路径

在线环境可以直接获取安装工具和依赖。离线环境则可以先制备部署包,将二进制文件、镜像、Chart 等依赖带到目标环境,再完成初始化和集群部署。

离线交付真正麻烦的地方通常不是“能不能下载”,而是制品是否完整、版本是否匹配、流程能否复现。把制品构建纳入 BKE 工具链,比临时拼凑镜像和安装包更可维护。

管理面与声明式 API 并存

Web 管理面降低了初次使用和日常操作的门槛;命令行与自定义资源则保留了自动化所需的可编程接口。

这两种方式并不矛盾:前者服务人的操作效率,后者服务系统集成和可重复的工程流程。

多架构与可插拔组件

官方文档列出了 openEuler、Ubuntu、UOS 等已测试操作系统,以及 x86_64、ARM64 架构支持。openFuyao 本身采用“核心平台 + 可插拔组件”的架构,BKE 负责把集群基础和管理入口搭好,后续组件可以按需安装。

具体版本和操作系统组合仍应以对应版本的官方安装文档为准,不宜把“支持多架构”理解成任意版本组合都已验证。

为什么这套设计值得尝试

BKE 最吸引我的地方,是用 Kubernetes 的方式管理 Kubernetes。

传统安装脚本更关注命令是否执行完成;声明式模型还会持续比较期望状态和实际状态,并通过资源状态反馈结果。集群配置因此不再只存在于某位工程师的脚本或操作记录里,而是成为可以查看、评审和自动处理的 API 对象。

当然,声明式不等于“零排障”。网络、SSH、时间同步、节点残留组件和离线制品完整性,仍然会影响安装结果。BKE 的价值不是消灭这些基础条件,而是把执行流程、状态反馈和后续运维统一起来,让问题更容易定位,让成功路径更容易复制。

快速体验

官方快速入门建议准备两台机器,分别作为引导节点和业务集群节点。其最小化部署参考配置如下;这只用于快速体验,不是生产环境推荐配置。

节点 数量 CPU 内存 系统盘
引导节点 1 2 核 4 GB ≥ 100 GB
业务集群节点 1 8 核 16 GB ≥ 100 GB

在引导节点上,可以按官方文档下载并校验安装工具:

curl -LO https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/latest/download.sh
curl -LO https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/latest/download.sh.sha256
sha256sum -c <(cat download.sh.sha256) < download.sh
chmod +x download.sh && ./download.sh

然后初始化引导节点:

bke init --onlineImage cr.openfuyao.cn/openfuyao/bke-online-installed:latest

看到 BKE initialization is complete 后,可以通过 https://<引导节点IP>:30010 访问引导集群管理面,继续创建业务集群。首次登录后应按提示修改初始凭据。

完整的节点要求、前置检查和业务集群安装步骤,请直接参考官方快速入门。生产、高可用和离线场景应从安装前必读开始,不要直接套用体验环境配置。

从使用者成为贡献者

BKE 相关代码和文档托管在 GitCode 的 openFuyao 组织下,可以按兴趣选择入口:

仓库 主要内容
bkeadm bke 命令行工具、初始化与部署包构建
cluster-api-provider-bke Cluster API 基础设施 Provider 与集群控制逻辑
bkeagent 节点侧代理相关实现
bkecommon 公共 API、配置解析与其他公共模块
bke-manifests 产品组件部署清单与模板
sig-installation 安装文档、设计提案、SIG 信息与贡献指南

参与社区不一定从修改控制器代码开始。一次可复现的 Issue、一段补充完善的安装文档、一个边界场景的测试用例,都是很实际的贡献。

如果想进一步了解设计动机,可以阅读 sig-installation 中的设计文档;准备提交代码时,先阅读对应仓库的贡献指南,并通过 Issue 或 PR 与维护者讨论。社区会议议程和邮件订阅入口可以在 openFuyao 会议页面找到,安装部署 SIG 邮箱为 installation@list.openfuyao.cn。

结语

Kubernetes 集群交付的难点,从来不只是把 apiserver 启动起来,而是让创建、变更和故障处理都能沿着一条可观察、可重复的路径进行。

BKE 把这条路径落到 Cluster API、基础设施 Provider 和节点代理之上,再通过管理面降低使用门槛。无论你是在寻找离线 Kubernetes 集群交付方案,还是希望把多集群运维改造成声明式流程,都值得给它一次实际部署的机会。

先从一个小规模测试集群开始,再把问题、建议或补丁带回社区。开源项目真正的生命力,就来自这条从使用到共建的回路。