Skip to content

Creating a Cluster on Non-Supported Operating Systems

This document outlines how to create a worker cluster on an unsupported OS in offline mode.

The main process for creating a worker cluster on an unsupported OS in offline mode is illustrated in the diagram below:

Process

Next, we will use the openAnolis operating system as an example to demonstrate how to create a cluster on a non-mainstream operating system.

Prerequisites

  • AI platform Full Mode has been deployed.
  • At least one node with the same architecture and version that can connect to the internet.

Procedure

Online Node - Building an Offline Package

Find an online environment with the same architecture and OS as the nodes in the target cluster. In this example, we will use AnolisOS 8.8 GA. Run the following command to generate an offline os-pkgs package:

# Download relevant scripts and build os packages package
$ curl -Lo ./pkgs.yml https://raw.githubusercontent.com/kubean-io/kubean/main/build/os-packages/others/pkgs.yml
$ curl -Lo ./other_os_pkgs.sh https://raw.githubusercontent.com/kubean-io/kubean/main/build/os-packages/others/other_os_pkgs.sh && chmod +x other_os_pkgs.sh
$ ./other_os_pkgs.sh build # Build the offline package

After executing the above command, you should have a compressed package named os-pkgs-anolis-8.8.tar.gz in the current directory. The file structure in the current directory should look like this:

    .
    ├── other_os_pkgs.sh
    ├── pkgs.yml
    └── os-pkgs-anolis-8.8.tar.gz

Offline Node - Installing the Offline Package

Copy the three files generated on the online node ( other_os_pkgs.sh , pkgs.yml , and os-pkgs-anolis-8.8.tar.gz ) to all nodes in the target cluster in the offline environment.

Login to any one of the nodes in the offline environment that is part of the target cluster, and run the following command to install the os-pkg package on the node:

# Configure environment variables
$ export PKGS_YML_PATH=/root/workspace/os-pkgs/pkgs.yml # Path to the pkgs.yml file on the current offline node
$ export PKGS_TAR_PATH=/root/workspace/os-pkgs/os-pkgs-anolis-8.8.tar.gz # Path to the os-pkgs-anolis-8.8.tar.gz file on the current offline node
$ export SSH_USER=root # Username for the current offline node
$ export SSH_PASS=dangerous # Password for the current offline node
$ export HOST_IPS='172.30.41.168' # IP address of the current offline node
$ ./other_os_pkgs.sh install # Install the offline package

After executing the above command, wait for the interface to prompt: All packages for node (X.X.X.X) have been installed , which indicates that the installation is complete.

Go to the User Interface to Create Cluster

Refer to the documentation on Creating a Worker Cluster to create an openAnolis cluster.