Skip to main content
Version: v25.03

Online Management Cluster Installation

Configuration Requirements

Table 1 Hardware configuration for minimum deployment

Node TypeNumber of NodesNumber of CPUsMemory (GB)Disk Space
Bootstrap node124System drive ≥ 100 GB
Management cluster node1816System drive ≥ 100 GB
Service cluster node1816System drive ≥ 100 GB

Table 2 Recommended hardware configuration

Node TypeNumber of NodesNumber of CPUsMemory (GB)Disk Space
Bootstrap node124System drive ≥ 100 GB
Management cluster3816System drive ≥ 100 GB
Data drive ≥ 300 GB
Service clusterDepending on the actual situationDepending on the actual situationDepending on the actual situationDepending on the actual situation

Environment Preparation

Prepare a bare-metal server (BMS) and perform the following steps:

Input image descriptionNOTE
If you do not have enough hosts, you can deploy the bootstrap node and cluster management node on the same host.

Procedure

  1. Run the following command to download and automatically install the bkeadm on the bootstrap node:

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

    If the Cluster API package is downloaded from the official website, run the following command to decompress the package and move bkeadm_linux_$ARCH to /usr/bin/bke:

    mv <bkeadm_linux_$ARCH path eg: xx/bkeadm_linux_$ARCH>   /usr/bin/bke
  2. Run the following command to initialize the bootstrap node:

    This step starts the image repository, chart repository, NFS server, HTTP service, and repo repository, as well as installs the K3s cluster. It will then deploy Cluster API and cluster-api-provider-bke within the K3s cluster.

    bke init --otherRepo harbor.openfuyao.com/openfuyao/bke-online-installed:v0.0.4
  3. Run the following command to perform online deployment:

    3.1 Modify the cluster configuration file 1master.yaml in the /bke/cluster/ folder to create a standard YAML file template.

      vi /bke/cluster/1master.yaml

    3.2 The configuration items are as follows:

     nodes:
    - hostname: master-1 # Configuration item
    ip: xx # Configuration item
    password: xx # Configuration item
    port: xx # Configuration item
    role:
    - master/node
    - etcd
    username: root

    3.3 Run the following command to install the management cluster on the bootstrap node and create a cluster with only one master node:

      bke cluster create -f 1master.yaml

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 bke reset --all --mount 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