Skip to main content
Version: v25.09

Offline Incremental Component Installation

Context​

In the offline environment, a service cluster is installed in Cluster API mode in the openFuyao community. Subsequently, new extensions need to be incrementally installed in the existing cluster without the need to re-prepare offline artifact packages and reinstall the entire cluster.

Environment Preparation​

  • Prepare a bare-metal server (BMS). (The BMS must support Internet access and is used to build incremental component installation packages in online scenarios.)
  • Install tar, pigz, bkeadm, and Docker (no specific Docker version is required).
    • For details about the tar tool installation version, see https://mirrors.aliyun.com/gnu/tar/.
    • For details about the pigz tool installation version, see https://zlib.net/pigz/.
    • You can run the following command to download and install bkeadm: 
      curl -sfL https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/v25.09/download.sh | bash

Installation Procedure​

Perform the following steps to install an incremental component:

  1. Prepare an incremental image installation package.

    1.1 After Docker is installed, add the following configuration to the Docker configuration file. Edit the /etc/docker/daemon.json file. Create the file if it does not exist.

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

    1.2 Run the following command to restart Docker:

    systemctl restart docker

    1.3 Prepare the YAML file of the images on which the component depends. The following is an example YAML file for downloading the images of the logging-packages component in the openFuyao community.

    registry:
      imageAddress: cr.openfuyao.cn/openfuyao/registry:2.8.1
      architecture:
        - amd64
        - arm64
    repos:
      - architecture: # openFuyao logging extension
          - amd64
          - arm64
        needDownload: true # Whether to download the images required by the logging extension. **false**: no; **true**: yes.
        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 Prepare the incremental image installation package patch-log.tar.gz.

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

  2. Copy the offline incremental image installation package to the offline bootstrap node.

  3. Download the chart package from the repository, log in to the openFuyao management plane, choose Application Market > Repository Configuration > Chart Management > Add Chart in the navigation pane, and upload the package to the local repository of the offline service cluster.

  4. Install the component.

    4.1 Synchronize the images to the offline bootstrap node.

    # Decompress the installation package.
    tar -xzvf patch-log.tar.gz
    # Synchronize images.
    bke registry patch --source ./patch-log --target 0.0.0.0:40443

    4.2 Install the component on the openFuyao management plane of the service cluster.

    Log in to the openFuyao management plane, choose Application Market > Applications in the navigation pane, and click the application card as required to enter the installation wizard.