Version: v26.03

Online Bootstrap Cluster Installation

Configuration Requirements

Table 1 Minimum Deployment Hardware Configuration

Node TypeNode QuantityvCPU (Count)Memory (GB)Hard Disk
Bootstrap Node124System disk>=100G
Service Cluster Node1816System disk>=100G

Table 2 Recommended Hardware Configuration

Node TypeNode QuantityvCPU (Count)Memory (GB)Hard Disk
Bootstrap Node124System disk>=100G
Service ClusterDetermined by actual situationDetermined by actual situationDetermined by actual situationDetermined by actual situation

Environment Preparation

Prepare two bare metal machines, respectively serving as the bootstrap node and deployment node for the service cluster. The bootstrap node needs to have the tar tool installed. For tar tool installation version, please refer to https://mirrors.aliyun.com/gnu/tar/.

Notice:
It is recommended that your node environment be a bare metal operating system with no docker or Kubernetes components installed, otherwise version conflicts may occur and cause installation failure. If you need to install experimentally in an existing environment, you can download the incubation tool env-check for environment verification.

Installation Steps

  1. Execute the following command on the bootstrap node to download and automatically install the BKE tool.

    bash
    # Method 1: Quick download
    curl -sfL https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/1.2.2/download.sh | bash
    bash
    # Method 2: Download with integrity verification
    ## Download download.sh script file
    curl -LO https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/1.2.2/download.sh
    ## Download the checksum file for download.sh and verify (optional). Successful verification will output -: OK. If verification fails, contact openFuyao community maintainers to locate the cause
    curl -LO https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/1.2.2/download.sh.sha256
    sha256sum -c <(cat download.sh.sha256) < download.sh
    ## Run download.sh to download the bke installation tool, which will verify sha256sum during execution
    chmod +x download.sh && ./download.sh
  2. Execute the following command to initialize the bootstrap cluster.

    This step will deploy a lightweight K3s cluster on the bootstrap node. The cluster will deploy cluster-api, provider-bke, and openFuyao installation and deployment related Pods.

    bash
    bke init --onlineImage cr.openfuyao.cn/openfuyao/bke-online-installed:1.2.2

    The above initialization operation will cause the Pods deployed on the bootstrap node to pull images from the online repository. If you want to obtain images from local, you can use the following command to specify the local installation package.

    bash
    bke init --onlineImage cr.openfuyao.cn/openfuyao/bke-online-installed:1.2.2 --installConsole=false --imageFilePath=/tmp/local_amd/image_amd64.tar.gz

    Where: imageFilePath points to the local installation package. For build method, please refer to Bootstrap Node Initialization Process Optimization.

    Caution:
    Bootstrap node initialization process optimization is only for minimal set initialization of the bootstrap node and will not deploy the frontend openFuyao interface.

  3. Execute the following command to view the Pods deployed on the bootstrap cluster.

    bash
    kubectl get pod -A

    After all Pod states are normal, the bootstrap cluster installation is complete, and you can continue to log in to the openFuyao bootstrap node's management plane for service cluster installation.

Uninstallation

  1. Execute the following command to reset the bootstrap cluster.

    bash
    bke reset --all --mount
  2. Execute the following command to completely uninstall BKE related content.

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