Cluster hosting

For kubernetes clusters running outside the kubeclipper platform, you can host them within the kubeclipper platform for management. The current version supports host kubeadmin clusters.

Kubeadm cluster hosting

For a host cluster created and managed by kubeadm, kubeclipper gets the cluster and node information from the kubeconfig file and imports it into the kubeclipper platform.

Click “Cluster Management” > “Cluster Hosting” button to enter the cluster hosting page. Click “Add” button at the upper left corner. In the pop-up window of Add Provider, fill in the provider name (such as kubeadm-demo) and description, and then fill in the following information:

  • Region: The region of the cluster and node in the kubeclipper platform.

  • Provider type: Select kubeadm.

  • SSH: Specifies the connection method of cluster nodes. Private Key or Password can be selected. Ensure that all cluster nodes can be connected through the selected method.

    • Private Key: enter the node user name and private key information.
    • Password: enter the node user name and password.
  • Cluster name: Specifies the display name on the platform and cannot be the same as any other clusters.

  • KubeConfig: The KubeConfig file of the host cluster.

Click the “OK” button to import the cluster and node into the platform. Click the provider name (kubeadm-demo) to enter the Provider detail page, where you can view the cluster under the provider and perform the following operations on the provider:

  • Synchronization: Kubeclipper synchronizes cluster information every four hours. You can also click “Synchronize” to manually perform the operation.
  • Edit: Edit the provider’s name, description, access information, and node connection method.
  • Remove: Remove the cluster information from kubeclipper, but the cluster will not be uninstalled.

Managed cluster management

You can choose “Cluster Management” > “Cluster” to go to the cluster list page and view the list of all clusters, including hosted clusters and local clusters. The following table lists the operations supported by different clusters:

Note that “” will be used as image resource by default when you install external storage and other plug-ins for host clusters. If you are in an offline environment, you need to fill in the address of the accessible private registry during plug-in installation. The private registry must be added to the CRI registry of the cluster. For details, refer to CRI Registry.

FunctionClusters created by KubeclipperHosted kubeadm cluster
View log
Retry after failed task
Access Kubectl
Save as template
CRI Registry
Add/remove cluster nodes
Cluster Backup and Recovery
Version Upgrade
Delete cluster
Remove cluster (provider)/
Reset status
Cluster plugin management
Update cluster certificate
View kubeconfig file