Skip to main content
Version: v25.06

Multi-Node Deployment (Non-HA)

This section describes how to install openFuyao on multiple nodes in non-HA mode based on Kubernetes. The following uses openEuler 22.03 on the Arm64 architecture as an example. The installation procedure is the same for other supported operating systems and architectures.

Configuration Requirements​

Node Resource Requirements​

Table 1 Recommended resource configuration of the worker node

vCPUsMemory (GB)
48

Input image descriptionNOTE
When simultaneous multithreading (SMT) or hyper-threading is disabled, a vCPU is equivalent to a physical core. After SMT or hyper-threading is enabled, the following formula is used for calculating the number of vCPUs: Number of vCPUs = (Number of threads per core x Number of cores) x Number of sockets.

Table 2 Recommended resource configuration of the master node

vCPUsMemory (GB)Number of Worker Nodes
4161–24
83225–100
1664101–150
2464151–200

Input image descriptionNOTE

  • The required resource of the master node increases with the number of worker nodes.
  • When SMT or hyper-threading is disabled, a vCPU is equivalent to a physical core. After SMT or hyper-threading is enabled, the following formula is used for calculating the number of vCPUs: Number of vCPUs = (Number of threads per core x Number of cores) x Number of sockets.

Node Configuration Requirements​

  • A host is available for performing the installation. It can be a node in the cluster or a host outside the cluster.
  • All hosts can access the Internet.
  • Root user login is available on all hosts.

Environment Preparation​

Prepare two Linux computers running openEuler 22.03.

Table 3 Environment information

Host IP AddressHost NameOperating SystemRole
192.168.0.3node2openEulerControl plane
192.168.0.4node3openEulerWorker node

Procedure​

  1. Log in to the installation host as the root user.

  2. Download the installation tool and installation script.

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

    By default, the installation package of the latest version is downloaded by running the preceding command. To download the installation package of another version, run the following command with VERSION set to the desired version:

    Input image descriptionNOTE
    For details about how to verify the integrity of the installation package, see Installation Package Integrity Verification.

    export VERSION=x.y.z

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

  3. Generate a cluster planning configuration file.

    • Go to the installation package directory.

    Input image descriptionNOTE
    Here uses openEuler 22.03 on the Arm64 architecture as an example. Adjust the path according to the actual situation.

    export INSTALLER_PACKAGE_PATH=fuyao-v25.06-openEuler-22.03-arm64

    cd $INSTALLER_PACKAGE_PATH
    • Run the following command to generate a configuration file:
    ./fuyao create cluster-config
    • The following shows the content of the configuration file.
    apiVersion: openfuyao.io/v1beta1
    kind: cluster
    metadata:
        name: example-cluster
    spec:
        nodes:
            masters:
                - hostname: fuyao-master
                  user: root
                  ip: o.x.y.z
                  port: 22
                  privateKeyPath: /root/.ssh/id_rsa
                  removeTaint: true
                  labels:
                    - name: label-name
                      value: label-value
            workers:
                - hostname: fuyao-worker
                  user: root
                  ip: o.x.y.z
                  port: 22
                  privateKeyPath: /root/.ssh/id_rsa
                  labels:
                    - name: label-name
                      value: label-value

  4. Modify the cluster planning configuration file.

    • Edit the cluster planning configuration file.
    export CLUSTER_CONFIG_FILE=example-cluster.yaml

    vi $CLUSTER_CONFIG_FILE

    • Enter the node list information. The following is an example.

      • You can enter information about only one master node and multiple worker nodes.
      • hostname: name of a node in the cluster, which can be different from the actual host name.
      • user: username for logging in to the node during deployment.
      • ip: IP address of the node.
      • port: port number used by SSH. The default value is 22.

    • Enter i to enter the edit mode for modifications. After the modifications are complete, enter :wq to save the modifications and exit. The following shows the modified configuration file.

    apiVersion: openfuyao.io/v1beta1
    kind: cluster
    metadata:
      name: example-cluster
    spec:
        # Specify the nodes.

nodes:

Master node configuration

masters:

The hostname in the cluster can be different from the hostname of the host.

  • hostname: fuyao-master # Configuration item user: root # Configuration item ip: 192.168.0.3 # Configuration item port: 22 # Configuration item

    privateKeyPath: /root/.ssh/id_rsa # Configuration item (optional)

    Set it to true to remove taints and make the master node schedulable.

    removeTaint: true # Configuration item (optional) labels:
    • name: fuyao-master # Configuration item (optional) value: node2 # Configuration item (optional) workers:
  • hostname: fuyao-worker # Configuration item user: root # Configuration item ip: 192.168.0.4 # Configuration item port: 22 # Configuration item

    privateKeyPath: /root/.ssh/id_rsa # Configuration item (optional)

    labels:
    • name: fuyao-worker # Configuration item (optional) value: node3 # Configuration item (optional)

- If SSH key–based login is configured for nodes in the cluster during configuration and installation, make sure to configure SSH key–based authentication on the installation host in advance.

5. Perform the installation in the installation package directory.

./fuyao create cluster -f $CLUSTER_CONFIG_FILE


- If password-based login is configured for nodes in the cluster, make sure to enter the corresponding node passwords as prompted during the installation.

6. Verify the installation.

- After the automatic installation is complete, **record the username and password for logging in to the openFuyao management plane**.
- Check the information about all pods on the host. If all pods are in running state, the environment is ready.

kubectl get pod -A


> ![Input image description](figures/icon-note.gif)**NOTE**<br />
> 
> - The installation is complete when all pods are in running state. The actual time may vary depending on actual network conditions.
> - The openFuyao authentication and authorization mechanism uses self-signed keys. All authentication and authorization keys and configuration files are stored under `/etc/kubernetes/webhook` on all master nodes. After the installation is complete, you may choose to remove the files in this path. However, if the files are removed and the API server is restarted, authentication will fail.
> - The components deployed using the installation and deployment tool are configured with default settings and are intended only for testing the openFuyao platform's functions. For a production environment, adjust the security configurations of Kubernetes, container runtime, and network plug-in components.

7. Log in to the openFuyao management plane.

Enter "https://_login IP address of the management plane_:_web service port of openFuyao_" in the address box of a browser, and enter the username and password to log in to the openFuyao management plane.<br />

> ![Input image description](figures/icon-note.gif)**NOTE** Changing the password is required upon the first login.<br /> The default web service port of openFuyao is **31616**.<br />

For details about the functions and usage of the openFuyao management plane, see [User Guide](../../6_User_Guide/1_Registration and Login.md).

## Uninstallation

1. Log in to the installation host as the root user.

2. Run the following command to enter the installation package directory:

```shell
cd $INSTALLER_PACKAGE_PATH
vi $CLUSTER_CONFIG_FILE

Input image descriptionNOTE

  • Edit the configuration file. The modifications to the configuration file should be consistent with those made during installation. Enter information about hostname, user, ip, port, and privateKeyPath for the master and worker nodes in the cluster.
  • If there are no changes to the nodes in the cluster, you can directly use the configuration file used during cluster installation to uninstall the cluster.

  1. Perform the uninstallation in the installation package directory.

    Input image descriptionNOTE
    If multiple applications or extensions are installed in the environment through the application market, you are advised to uninstall them through the application management or extension management function. Otherwise, the uninstallation may be slow or fail.

    ./fuyao destroy cluster -f $CLUSTER_CONFIG_FILE

  2. When Successfully completed cluster destroy is displayed, the cluster is uninstalled.

    During the uninstallation, the logs generated during the installation and uninstallation are not removed. The logs are stored under /var/log/fuyao-installer/. To remove these logs, run the following command:

    rm -rf /var/log/fuyao-installer/