註冊叢集是用於將本機資料中心Kubernetes叢集或其他雲廠商Kubernetes叢集接入阿里雲Container Service管理主控台統一管理的叢集形態。本文將介紹如何通過onectl建立一個註冊叢集並接入本機資料中心Kubernetes叢集。
前提條件
已在本地安裝配置onectl。具體操作，請參見通過onectl管理註冊叢集。
已配置網路接入。註冊叢集支援通過公網和內網接入。更多資訊，請參見接入註冊叢集的目的地組群對於網路連通性有什麼要求？。
操作步驟
onectl支援通過以下兩種方式建立註冊叢集。
重要在建立註冊叢集時，您需要輸入VPC、vSwitch、Region等資訊。當註冊叢集設定為公網可訪問時，為了提高安全性，您需要通過
--acl設定註冊叢集SLB的存取控制白名單，包括本地叢集的出網IP位址區段和訪問註冊叢集的源IP位址區段。非互動式建立：執行以下命令，建立註冊叢集。
onectl cluster create --region **** --vpc **** --vswitch ****互動式建立：執行以下命令，建立註冊叢集。
onectl cluster create -i
您可以執行以下命令查看具體的參數說明。
onectl cluster create -h註冊叢集在建立完成後，會進行一系列初始化的操作，此時叢集狀態為
initial。註冊叢集建立成功後，預期輸出：Registered cluster test-registered-cluster created successfully, information of the cluster: name = test-registered-cluster state = initial cluster id = c3c277f2fc10f45c1b86473********** region id = cn-zhangjiakou node numbers = 0 vpc id = vpc-8vb95w2o172********** vswitch id = vsw-8vbv8bxhput**********叢集初始化完成後進入
waiting等待串連的狀態，執行以下命令，查看叢集狀態。onectl cluster describe --cluster-id ****預期輸出：
name = test-registered-cluster state = waiting ...當叢集狀態為
waiting時，執行以下命令，將目的地組群接入註冊叢集。onectl cluster connect --cluster-id **** --kubeconfig ~/.kube/config --restricted true參數
是否必選
說明
cluster-id
是
上述步驟1中建立的註冊叢集的ID。
kubeconfig
否
目的地組群的KubeConfig設定檔的路徑。如未指定，將使用KUBECONFIG環境變數指向的設定檔。
restricted
否
是否以受限模式串連註冊叢集。更多資訊，請參見註冊叢集ack-cluster-agent組件RBAC許可權說明。
您還可以執行以下命令查看具體參數說明。
onectl cluster connect -h執行以下命令，查看目的地組群是否接入成功。
onectl cluster describe --cluster-id ****預期輸出：
name = test-registered-cluster state = running ...預期輸出表明叢集的狀態為running，註冊叢集已經串連成功。