离线组件增量安装

背景

离线环境使用了openFuyao社区的Cluster-API方式安装了业务集群，后续需要在已有的集群中安装新的扩展组件，做到增量安装，而无须重新制备离线制品包再进行集群的安装。

环境准备

• 准备一台裸机（裸机要求在公网环境下，用于在线场景中构建组件增量安装包）。
• 安装tar、pigz、bkeadm和Docker（Docker版本暂无要求）。

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

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

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

    curl -sfL https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/v25.09/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 准备组件依赖镜像的yaml文件，下面举例是openFuyao社区的logging-packages组件的镜像下载配置yaml文件。

   registry:
     imageAddress: cr.openfuyao.cn/openfuyao/registry:2.8.1
     architecture:
       - amd64
       - arm64
   repos:
     - architecture: # openfuyao logging 扩展组件
         - amd64
         - arm64
       needDownload: true # logging 扩展组件所需镜像是否下载开关，false-关闭不下载，true-开启下载
       subImages:
         - sourceRepo: cr.openfuyao.cn/openfuyao
           targetRepo: openfuyao
           images:
             - name: logging-operator
               tag:
                 - v25.09
             - name: logging-website
               tag:
                 - v25.09
             - name: oauth-proxy
               tag:
                 - v25.09
         - sourceRepo: docker.io
           targetRepo: /
           images:
             - name: grafana/loki
               tag:
                 - 2.9.1
             - name: grafana/promtail
               tag:
                 - 2.9.3
             - name: bats/bats
               tag:
                 - 1.8.2
   rpms:
   debs: []
   files: []
   charts: []

   1.4 制备镜像增量安装包，完成后会得到镜像增量安装包patch-log.tar.gz压缩文件。

   bke build patch -f offline.yaml -t patch-log.tar.gz

2. 将离线的镜像增量安装包复制到离线引导节点。

3. 仓库下载Chart包文件，登录openFuyao管理面，左侧导航栏选择“应用市场 > 仓库配置 > 包管理 > 添加包” 并将其上传到离线业务集群的local仓库。

4. 进行组件安装。

   4.1 离线引导节点镜像同步。

   # 解压安装包
   tar -xzvf patch-log.tar.gz
   # 镜像同步
   bke registry patch --source ./patch-log --target 0.0.0.0:40443

   4.2 业务集群的openFuyao管理面应用管理安装组件。

   登录openFuyao管理面，左侧导航栏选择“应用市场 > 应用列表”，根据安装需要单击应用卡片，进入安装引导流程。