Add a Member Cluster

Time updated：2025-12-22 09:26:17

This section describes how to add a member cluster.

Depending on your network environment, the host cluster and the member cluster can be connected in the following ways:

Direct connection: If the host cluster can access the Kubernetes API service of the member cluster, you can add the kubeconfig information of the member cluster to the host cluster to directly connect the host cluster and the member cluster.

Proxy connection: If the host cluster cannot access the Kubernetes API service of the member cluster, you can configure the member cluster to connect to the proxy service tower exposed by the host cluster, thereby connecting the host cluster and the member cluster through the proxy service tower.

Note
To use proxy connection, the KubeSphere Multi-Cluster Agent Connection extension must be installed and enabled on the KubeSphere platform. For more information, see Add a Member Cluster Using Proxy Connection.

Note

To use proxy connection, the KubeSphere Multi-Cluster Agent Connection extension must be installed and enabled on the KubeSphere platform. For more information, see Add a Member Cluster Using Proxy Connection.

Regardless of whether using direct connection or proxy connection, at least one of the host cluster and the member cluster must be able to access the service exposed by the other.