Skip to main content
Version: v25.06

Before You Start

Supported Environments​

Operating Systems​

Table 1 Supported operating systems

Operating SystemVersionArchitecture
openEuler20.03Arm64 and x86_64
openEuler22.03Arm64 and x86_64
openEuler24.03Arm64 and x86_64
Ubuntu22.04Arm64 and x86_64

Input image descriptionNOTE
Tests in other operating systems have not yet been performed, and unexpected issues may occur.

Kubernetes Versions​

  • v1.28: 1.28.8
  • v1.29: 1.29.1

Deployment Modes​

  • Online deployment

    • All-in-one (AIO) deployment
    • Multi-node deployment (non-HA)
    • High-availability (HA) deployment (HA deployment of API server)

  • Offline deployment

    • All-in-one (AIO) deployment
    • Multi-node deployment (non-HA)
    • High-availability (HA) deployment (HA deployment of API server)

Introduction to Cluster API​

Cluster API is a Kubernetes sub-project that allows automatic lifecycle management of Kubernetes clusters through declarative APIs and the controller pattern. Its key features are as follows:

  • Infrastructure as code: Users can use Kubernetes custom resources to define cluster configurations.
  • Declarative management: Users can describe the expected cluster status through YAML files.
  • Controller pattern: A controller can automatically make the current state come closer to the desired state.

Deployment Tool​

This section describes the installation using the BKE tool. The overall installation process is as follows: Perform initial configuration and installation on a bare-metal server (BMS), use the BMS as a bootstrap node, install the K3s lightweight cluster on the bootstrap node, and deploy Cluster API, provider-bke, and the openFuyao management plane. Then, service clusters can be installed, uninstalled, scaled up or down, and upgraded over the openFuyao management plane.

The BKE tool classifies hosts into two types: bootstrap node and service cluster node.

  • Bootstrap node: A lightweight K3s cluster is deployed as a long-term bootstrap cluster on this node for creating and managing target service clusters. Control plane components of Cluster API are running on this node.
  • Service cluster node: Target service clusters created and managed by Cluster API are deployed on service cluster nodes to run users' workloads. Their lifecycle is controlled by the bootstrap cluster.

Precautions​

  • The openFuyao management plane of the bootstrap node supports passwordless login. It runs over HTTP, with the web service port set to 30010 by default.
  • The openFuyao management plane of a service cluster node requires user login. For the first login, the username is admin, and the password is test@1234. Both must be changed immediately after the first login. It runs over HTTP, with the web service port set to 31616 by default.
  • For cluster nodes or offline image repository nodes to be installed using openFuyao installation tools, if Docker or Docker CE has been installed, uninstall it first.