如何通过onectl创建注册集群_容器服务 Kubernetes 版 ACK(ACK)-阿里云帮助中心

备案控制台

文档

输入文档关键字查找

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

反馈

本页导读（1）