< img height="1" width="1" style="display:none;" alt="" src="https://px.ads.linkedin.com/collect/?pid=3131724&fmt=gif" />

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 a user that has the permission to create a workspace, such as ws-manager.

  2. Click Platform in the upper-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 Cluster Settings page, you can see a list of available clusters. Select the clusters 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 a user that has the permission to manage clusters, such as admin.

  2. Click Platform in the upper-left corner and select Cluster 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 visibility. 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.

Receive the latest news, articles and updates from KubeSphere

Thanks for the feedback. If you have a specific question about how to use KubeSphere, ask it on Slack. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.