版本:v25.12

离线组件增量安装

背景

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

环境准备

  • 准备一台裸机(裸机要求在公网环境下,用于在线场景中构建组件增量安装包)。
  • 安装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 准备组件依赖镜像的yaml文件,下面举例是openFuyao社区的logging-packages组件的镜像下载配置yaml文件。

    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:
                  - latest
              - name: logging-website
                tag:
                  - latest
              - name: oauth-proxy
                tag:
                  - latest
          - 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压缩文件。

    bash
    bke build patch -f offline.yaml -t patch-log.tar.gz
  2. 将离线的镜像增量安装包复制到离线引导节点。

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

  4. 进行组件安装。

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

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

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

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