You are viewing documentation for KubeSphere version:v3.0.0

KubeSphere v3.0.0 documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.

Cluster Visibility and Authorization

In KubeSphere, you can allocate a cluster to multiple workspaces through authorization so that workspace resources can all run on the cluster. At the same time, a workspace can also be associated with multiple clusters. Workspace users with necessary permissions can create multi-cluster projects using clusters allocated to the workspace.

This guide demonstrates how to set cluster visibility.


Set Cluster Visibility

Select available clusters when you create a workspace

  1. Log in to KubeSphere with an account that has the permission to create a workspace, such as ws-manager.

  2. Click Platform in the top left corner and select Access Control. In Workspaces from the navigation bar, click Create.


  3. Provide the basic information for the workspace and click Next.

  4. On the Select Clusters page, you can see a list of available clusters. Check the cluster that you want to allocate to the workspace and click Create.


  5. After the workspace is created, workspace members with necessary permissions can create resources that run on the associated cluster.



    Try not to create resources on the host cluster to avoid excessive loads, which can lead to a decrease in the stability across clusters.

Set cluster visibility after a workspace is created

After a workspace is created, you can allocate additional clusters to the workspace through authorization or unbind a cluster from the workspace. Follow the steps below to adjust the visibility of a cluster.

  1. Log in to KubeSphere with an account that has the permission to manage clusters, such as admin.

  2. Click Platform in the top left corner and select Clusters Management. Select a cluster from the list to view cluster information.

  3. In Cluster Settings from the navigation bar, select Cluster Visibility.

  4. You can see the list of authorized workspaces, which means the current cluster is available to resources in all these workspaces.


  5. Click Edit Visibility to set the cluster authorization. You can select new workspaces that will be able to use the cluster or unbind it from a workspace.


Make a cluster public

You can check Set as public cluster so that platform users can access the cluster, in which they are able to create and schedule resources.