All-in-One Installation on Linux

For those who are new to Kube AI Hub and looking for a quick way to get started with the container platform, the all-in-one installation mode is the best choice to help you deploy Kube AI Hub and Kubernetes with zero configuration.

Step 1: Prepare a Linux Machine

To get started with all-in-one installation, you only need to prepare one host according to the following requirements for hardware and operating system.

Hardware Recommendations

Node Requirements

• The node must be accessible through SSH.
• sudo/curl/openssl/tar should be used on the node.

Container Runtimes

The cluster uses containerd as the container runtime. Docker is no longer supported. If you use KubeKey to set up a cluster, KubeKey will install containerd automatically.

Dependency Requirements

KubeKey can install Kubernetes and Kube AI Hub together. The dependency that needs to be installed may be different based on the Kubernetes version to be installed. You can refer to the list below to see if you need to install relevant dependencies on your node in advance.

Network and DNS Requirements

• Make sure the DNS address in /etc/resolv.conf is available. Otherwise, it may cause some issues of DNS in the cluster.
• If your network configuration uses firewall rules or security groups, you must ensure infrastructure components can communicate with each other through specific ports. It is recommended that you turn off the firewall. For more information, see Port Requirements.
• Supported CNI plugins: Calico and Flannel. Others (such as Cilium and Kube-OVN) may also work but note that they have not been fully tested.

Step 2: Get KubeKey

KubeKey is included in the Kube AI Hub offline installation package. After extracting the package, select the binary for your architecture:

# x86_64 architecture
mv kk-x86 kk

# ARM64 architecture
mv kk-arm kk

chmod +x kk

Step 3: Get Started with Installation

In this quick start tutorial, you only need to execute one command for installation:

./kk create cluster -i inventory.yaml -c config.yaml

After you execute the command, KubeKey will check your installation environment and show the results in a table. For more information, see Node Requirements and Dependency Requirements. Enter yes to continue the installation process.

Step 4: Verify the Installation

Enter the following command to check the installation result.

kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l 'app in (ks-install, ks-installer)' -o jsonpath='{.items[0].metadata.name}') -f

The output displays the IP address and port number of the web console, which is exposed through NodePort 30880 by default. Now, you can access the console at <NodeIP>:30880 with the default account and password (admin/P@88w0rd).

#####################################################
###              Welcome to Kube AI Hub!           ###
#####################################################

Console: http://192.168.0.2:30880
Account: admin
Password: P@88w0rd

NOTES：
  1. After you log into the console, please check the
     monitoring status of service components in
     "Cluster Management". If any service is not
     ready, please wait patiently until all components 
     are up and running.
  2. Please change the default password after login.

#####################################################

After logging in to the console, you can check the status of different components in System Components. You may need to wait for some components to be up and running if you want to use related services. You can also use kubectl get pod --all-namespaces to check the running status of Kube AI Hub components.

Enable Pluggable Components (Optional)

This guide is only used for minimal installation by default. To enable other components in Kube AI Hub, see Enable Pluggable Components.