离线安装管理集群

配置要求

表1 最小化部署硬件配置

节点类型	节点数量	CPU（个）	内存（GB）	硬盘
引导节点	1	2	4	系统盘>=100G
管理集群节点	1	8	16	系统盘>=100G
业务集群节点	1	8	16	系统盘>=100G

表2 推荐硬件配置

节点类型	节点数量	CPU（个）	内存（GB）	硬盘
引导节点	1	2	4	系统盘>=100G
管理集群	3	8	16	系统盘>=100G 数据盘>=300G
业务集群	根据实际情况定	根据实际情况定	根据实际情况定	根据实际情况定

环境准备

• 准备一台裸机（裸机要求在公网环境下，用于在线场景中构建离线安装包），需确保这台机器没有/bke目录 。 安装tar、pigz、bkeadm和docker（docker版本暂无要求）。

  说明：
  裸机配置可参考上述配置要求章节的引导节点相关配置信息。

  • tar工具安装版本可参考https://ftp.gnu.org/gnu/tar/。

  • pigz工具安装版本可参考 https://zlib.net/pigz/。

  • bkeadm下载可执行如下命令进行安装。

    curl -sfL https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/v25.03/download.sh | bash

安装步骤

1. 构建部署包。

   1.1 完成docker安装后，在docker配置文件中增加以下配置。

   编辑/etc/docker/daemon.json文件（如果没有就创建一个）

   {
   "insecure-registries": [     
     "0.0.0.0/0"
   ]    
   }

   1.2 执行如下命令，重启docker。

     systemctl restart docker

   1.3 构建离线安装部署包。

   • 收集二进制文件、rpm包、Chart包等最后生成一个压缩包，offline-artifacts.yaml可单击下载。

      rm -rf /bke && bke build -f offline-artifacts.yaml -t bke.tar.gz

     说明： 持续时长大约1小时。 导包过程中出现报错会有重试机制，非导致过程终止的报错可忽略。

2. 进行离线安装。

   2.1 将部署包从在线环境中拷贝到离线环境引导节点（根据实际情况操作）。

   2.2 执行如下命令，解压部署包到根目录。

    rm -rf /bke && tar zxvf <部署包名字 eg: bke.tar.gz> -C /

   说明：
   建议解压后根目录存储空间大于29GB，否则影响初始化。

3. 修改BKE安装工具名称，并初始化引导节点。

   # 修改安装工具名称
   ARCH=$(uname -m)
   case $ARCH in
   x86_64) ARCH="amd64";;
   aarch64) ARCH="arm64";;
   esac
   mv /usr/bin/bkeadm_linux_$ARCH /usr/bin/bke
    
   # 初始化引导节点
   bke init 

4. 执行如下命令，修改集群配置文件。

   vim /bke/cluster/1master.yaml

   修改项目如下：

   ...
   addons:
   - name: kubeproxy
     param:
       clusterNetworkMode: calico
     version: v1.28.8
   - name: calico
     param:
       calicoMode: vxlan
       ipAutoDetectionMethod: skip-interface=nerdctl*
     version: v3.25.0
   - name: coredns
     version: v1.10.1
   - name: openfuyao-system-controller
     param:
       helmRepo: https://harbor.openfuyao.com/chartrepo/openfuyao  # 修改项，修改为 http://init节点ip:38080
     version: latest
   ...
   nodes:
   - hostname: master-1  # 修改项
     ip: xx     # 修改项
     password: xx  # 修改项
     port: xx         # 修改项
      role:
     - master/node
     - etcd
     username: root
   ...

5. 执行如下命令，进行离线安装管理集群。

   bke cluster create -f 1master.yaml

   至此，等待所有Pod状态正常后，则管理集群安装完毕，可以继续登录openFuyao管理面进行业务集群的安装。

卸载

1. 执行如下命令，在管理集群上下载安装对应版本的bkeadm。

   curl -sfL https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/v25.03/download.sh | bash

2. 在引导节点和管理集群上分别都执行bke reset --all --mount完成引导节点的重置和业务集群的卸载。

3. 执行如下命令，完全卸载BKE相关内容。

   rm -rf /bke