Manage a Multi-cluster Environment on KubeSphere

    • Make sure your Kubernetes clusters are installed with KubeSphere before you use them as your Host Cluster and Member Clusters.

    • Make sure the cluster role is set correctly on your Host Cluster and Member Clusters respectively, and the is the same between them.

    Manage your KubeSphere Multi-cluster Environment

    Once you build a multi-cluster environment on KubeSphere, you can manage it through the central control plane from your Host Cluster. When creating resources, you can select a specific cluster while the Host Cluster should be avoided in case of overload. It is not recommended to log in to the KubeSphere web console of your Member Clusters to create resources on them as some resources (for example, workspaces) won’t be synchronized to your Host Cluster for management.

    If you want to import the Member Cluster to a new Host Cluster while retaining existing projects, you can follow the steps as below.

    1. Run the following command on the Member Cluster to unbind the projects to be retained from your workspace.

    2. Run the following command on the Member Cluster to clear your workspace.

    3. When you create a workspace on the new Host Cluster and assign the Member Cluster to this workspace, run the following command on the Member Cluster to bind the projects retained for the workspace.

    If you want to let different users access different clusters, you can create workspaces and . After that, you can invite different users to these workspaces per access requirements for these users.

    KubeSphere provides some pluggable components that you can enable based on your needs. In a multi-cluster environment, you can choose to enable these components on your Host Cluster or Member Cluster.

    For example, you only need to enable the App Store on your Host Cluster and you can use functions related to the App Store on your Member Clusters directly. For other components, when you enable them on your Host Cluster, you still have to manually enable the same components on your Member Cluster to implement the same features. Besides, you can also enable components only on your Member Cluster to implement corresponding features solely on your Member Cluster.

    For more information about how to enable pluggable components, refer to Enable Pluggable Components.