注册集群是用于将本地数据中心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,注册集群已经连接成功。