离线安装引导集群 ​

配置要求 ​

表1 最小化部署硬件配置

表2 推荐硬件配置

环境准备 ​

• 准备一台裸机（裸机要求在公网环境下，用于在线场景中构建离线安装包）。

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

• 确保这台机器没有/bke目录 。

• 安装tar、pigz、bkeadm和Docker（Docker版本暂无要求）。

  • tar工具安装版本可参考https://mirrors.aliyun.com/gnu/tar/。

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

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

    bash

    # 方式1：快捷下载
    curl -sfL https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/1.0.5/download.sh | bash
    # 方式2：校验下载文件的完整下载
    ## 下载download.sh脚本文件
    curl -LO https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/1.0.5/download.sh
    ## 下载download.sh文件的校验文件并进行校验（可选），校验成功会输出download.sh: OK，校验失败就需要联系openFuyao社区维护人员定位原因
    curl -LO https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/1.0.5/download.sh.sha256
    sha256sum -c download.sh.sha256
    ## 运行download.sh文件下载bke安装工具，执行过程中会校验安装工具的sha256sum
    chmod +x download.sh && ./download.sh

安装步骤 ​

1. 构建部署包。

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

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

   json

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

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

   bash

    systemctl restart docker

   1.3 构建离线安装部署包。

   收集二进制文件、RPM包、Chart包等最后生成一个压缩包，Core-VersionConfig-v25.12.yaml可单击下载。

   执行如下命令，构建离线安装部署包。

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

   bash

   rm -rf /bke && bke build -f Core-VersionConfig-v25.12.yaml -t bke.tar.gz

2. 进行引导节点离线安装。

   ⚠️ 重要提醒： 引导节点存在docker、containerd等容器运行时或相关系统残留文件会导致openFuyao对容器运行时的配置无法生效，从而导致安装失败。 为确保安装成功，建议使用全新裸机进行安装。

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

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

   bash

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

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

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

   bash

   # 修改安装工具名称
   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. 执行如下命令，可以查看引导集群上部署的Pod。

   bash

   kubectl get pod -A

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

卸载 ​

1. 执行如下命令，重置引导集群。

   bash

   bke reset --all --mount

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

   bash

   rm -rf /bke
   rm -f /usr/bin/bke