Offline Management Cluster Installation

Configuration Requirements

Table 1 Hardware configuration for minimum deployment

Node Type	Number of Nodes	Number of CPUs	Memory (GB)	Disk Space
Bootstrap node	1	2	4	System drive ≥ 100 GB
Management cluster node	1	8	16	System drive ≥ 100 GB
Service cluster node	1	8	16	System drive ≥ 100 GB

Table 2 Recommended hardware configuration

Node Type	Number of Nodes	Number of CPUs	Memory (GB)	Disk Space
Bootstrap node	1	2	4	System drive ≥ 100 GB
Management cluster	3	8	16	System drive ≥ 100 GB Data drive ≥ 300 GB
Service cluster	Depending on the actual situation	Depending on the actual situation	Depending on the actual situation	Depending on the actual situation

Environment Preparation

• Prepare a bare-metal server (BMS). (The BMS must support public Internet access and is used to build offline installation packages in online scenarios.) Ensure that no /bke directory exists on the BMS. Install tar, pigz, bkeadm, and Docker (no specific Docker version is required).

  NOTE
  For configuration requirements on the BMS, see the configuration information about the bootstrap node in the preceding Configuration Requirements section.

  • For tar installation, see https://ftp.gnu.org/gnu/tar/.

  • For pigz installation, see https://zlib.net/pigz/.

  • Run the following command to install bkeadm:

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

Procedure

1. Build the deployment 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 Build an offline installation and deployment package.

• Collect binary files, RPM packages, chart packages, and other files and generate a compressed package. You can click Download to download the offline-artifacts.yaml.

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

  NOTE The process takes about 1 hour. A retry mechanism is provided if an error is reported during package creation. Ignore the errors that do not cause the process to stop.

2. Perform offline installation.

   2.1 Copy the deployment package from the online environment to the bootstrap node in the offline environment (operations vary with the actual situation).

   2.2 Run the following command to decompress the deployment package to the root directory:

    rm -rf /bke && tar zxvf <deployment package name eg: bke.tar.gz> -C /

   NOTE
   It is recommended that the storage space of the root directory after decompression be greater than 29 GB. Otherwise, initialization will be affected.

3. Rename the BKE installation tool and initialize the bootstrap node.

 # Change the installation tool name.
 ARCH=$(uname -m)
 case $ARCH in
 x86_64) ARCH="amd64";;
 aarch64) ARCH="arm64";;
 esac
 mv /usr/bin/bkeadm_linux_$ARCH /usr/bin/bke
  
 # Initialize the bootstrap node.
 bke init 

4. Run the following command to modify the configuration file of the cluster:

   vim /bke/cluster/1master.yaml

   The configuration items are as follows:

   ...
   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  # Configuration item. Change it to http://init node ip:38080
     version: latest
   ...
   nodes:
   - hostname: master-1  # Configuration item
     ip: xx     # Configuration item
     password: xx  # Configuration item
     port: xx         # Configuration item
      role:
     - master/node
     - etcd
     username: root
   ...

5. Run the following command to install the management cluster offline:

   bke cluster create -f 1master.yaml

   The management cluster installation is complete after all pods are in a normal state. You can log in to the openFuyao management plane to perform service cluster installation.

Uninstallation

1. Run the following command to download and install the bkeadm of the corresponding version in the management cluster:

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

2. Run the command on both the bootstrap node and the management cluster to reset the bootstrap node and uninstall the service cluster.

3. Run the following command to fully remove all BKE-related content:

   rm -rf /bke