注册集群是用于将本地数据中心Kubernetes集群或其他云厂商Kubernetes集群接入阿里云容器服务管理控制台统一管理的集群形态。本文将介绍如何通过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，注册集群已经连接成功。