安装须知 ​

支持环境 ​

该章节介绍openFuyao安装工具支持的OS系统和使用的K8s组件版本。

操作系统 ​

表1 支持操作系统信息

说明：
其他版本操作系统暂未测试，可能会出现不在预期内的问题。

社区基于5.10内核进行功能开发和自验证，在openEuler环境进行兼容性测试，内核版本包含4.19、5.10、5.15和6.6。

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

部署形态 ​

• 在线部署

  • 单节点部署（AIO）
  • 多节点部署
  • 高可用部署（HA，apiserver高可用部署）

• 离线部署

  • 单节点部署（AIO）
  • 多节点部署
  • 高可用部署（HA，apiserver高可用部署）

Cluster-API简介 ​

Cluster-API是一个Kubernetes子项目，通过声明式API和控制器模式实现了Kubernetes集群的生命周期管理自动化，其核心介绍如下。

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

部署工具 ​

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

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

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

注意事项 ​

• 引导节点的openFuyao管理面首次登录时，用户名为admin，密码为test@1234。首次登录后需要修改用户名和密码。使用的https协议，web服务端口默认为30010。
• 业务集群节点的openFuyao管理面首次登录时，用户名为admin，密码为test@1234。首次登录后需要修改用户名和密码。使用的https协议，web服务端口默认为31616。
• 建议您的节点环境为裸机操作系统，未安装任何docker与Kubernetes组件，否则可能会发生版本冲突导致安装失败。如需在存量环境试验性安装，可下载孵化期工具env-check进行环境校验。
• 待安装集群节点的时间需要确保和引导节点的时间一致，时间差上限为10s。
• 可选：在进行安装部署之前，可以使用envCheck工具对环境中的残留文件和冲突应用程序进行检测，使用教程请参见安装部署前置环境校验工具使用指导。
• 可选：如需使用自定义CA证书来签发Kubernetes集群内所有组件的证书，以满足企业级安全合规要求，可在引导节点创建之前配置自定义证书。详细操作请参考自定义集群证书使用指导。
• 可选：如需配置自定义仓库进行安装请参见自定义仓库使用指导。
• 可选：如需通过addon安装NUMA亲和拓展插件请参见使用addon安装NUMA亲和扩展组件使用指导。
• 可选：如需对节点打标签并在addon中编辑标签亲和请参见节点标签亲和部署使用指导。
• 可选：如需containerd和kubelet自定义配置请参见二进制文件自定义使用指导。
• 可选：如需通过addon安装自定义扩展件请参见addon使用指导。