ACK One注册集群是用于将本地数据中心Kubernetes集群或其他云厂商Kubernetes集群接入阿里云容器服务管理平台统一管理的集群形态。本文介绍如何创建ACK One注册集群并将本地数据中心Kubernetes集群接入。
阅读本文前,建议您通过注册集群概述了解ACK One注册集群相关概念及应用场景。
前提条件
ACK注册集群提供公网和内网接入端点。关于如何通过绑定EIP开通公网访问能力,请参见实现从公网访问API Server。
在以下场景必须使用内网接入:
使用注册集群节点池功能为目标集群扩容阿里云ECS或弹性裸金属服务器。具体操作,请参见构建混合弹性容器集群(弹性ECS)。
使用注册集群托管ack-virtual-node组件为目标集群部署扩容弹性ECI实例。具体操作,请参见通过虚拟节点将Pod调度到ECI上运行。
请确保目标集群网络可以正常访问注册集群接入端点的5533端口。关于云上云下网络专线接通方案,请参见功能特性。
其他集群管理、安全治理、日志监控告警等功能对内网连通性无要求,但需确保目标集群可访问公网。
操作步骤
通过控制台创建ACK One注册集群并接入目标集群
创建ACK One注册集群
登录容器服务管理控制台,在左侧导航栏选择集群列表。
在页面左侧顶部,选择目标资源所在的资源组和地域。
在集群列表页面,单击创建集群。
单击ACK One 注册集群页签,按照页面指引完成集群配置。
配置项
说明
集群名称
自定义集群的名称。
地域
集群所在的开服地域。所选地域与用户和资源部署地域的距离越近,网络时延越低,访问速度越快。
IPv6双栈
公测中,请前往配额平台申请。
开启IPv6双栈后,将创建IPv4/IPv6双栈集群。
专有网络
配置集群的专有网络VPC。支持指定可用区自动新建一个VPC,也可以在已有VPC列表中选择已创建的VPC。
交换机
在列表中根据可用区选择已有vSwitch交换机,或单击创建虚拟交换机创建新的vSwitch。集群控制面与默认节点池将使用此处指定的vSwitch。推荐选择多个不同可用区的vSwitch,更好地保障集群高可用。
安全组
API server 访问
为API Server创建一个按量付费的私网CLB实例,作为集群API Server的内网连接端点。API Server提供了各类资源对象(Pod、Service等)的增删改查及Watch等HTTP Rest接口。
支持选择是否开放使用 EIP 暴露 API Server。
开放:开启后,将为 API Server 私网 CLB 实例绑定一个 EIP,获得从公网访问集群 API Server 的能力。
不开放:不会创建EIP,仅能在VPC内使用KubeConfig连接并操作集群。
重要删除默认创建的CLB实例会导致API Server无法访问。
绑定EIP到CLB实例后,API Server可以通过公网接收请求,但集群内的资源无法通过此访问公网。如需让集群内的资源访问公网(例如拉取公共镜像),请勾选为专有网络配置 SNAT。
自2024年12月01日起,新创建的CLB实例不再支持包年包月付费类型,同时将新增收取实例费。详细信息请参见【产品公告】关于取消新增集群API Server负载均衡CLB包年包月付费的公告、传统型负载均衡CLB计费项调整公告。
绑定公网IP
设置是否启用绑定EIP。选中此选项,会在集群中自动绑定EIP,用于建立集群链接。
说明公网接入必选项;如果云上云下集群已通过专线接通网络,可以不勾选。
集群删除保护
推荐开启集群删除保护,防止通过控制台或OpenAPI误删除集群。
资源组
创建的集群将归属于选择的资源组。一个资源只能归属于一个资源组。根据不同的业务场景,您可以将资源组映射为项目、应用或组织等概念。
标签
为集群绑定标签,作为云资源的标识,采用键值对格式。
服务协议
创建集群前,需阅读《阿里云产品服务协议》、《服务等级协议》以及页面中您勾选过的产品专属条款(若有)。
配置完成后,单击创建集群。创建完成后,可以在集群列表看到创建的集群。
将目标集群接入ACK One注册集群
找到新创建的ACK One注册集群,单击其右侧操作列下的详情。
在集群信息页面单击连接信息页签。在连接信息页签中根据需要选择公网或者私网,然后单击右侧的复制。
将连接信息复制到目标集群的一个文件中,并执行kubectl命令,将目标集群注册至新集群中。
例如,您可以新建agent.yaml文件,将连接信息复制到agent.yaml文件中,并在目标集群中执行
kubectl apply -f agent.yaml
命令。在目标集群中执行以下命令,查看代理运行状况。
kubectl -n kube-system get pod |grep ack-cluster-agent
预期输出:
ack-cluster-agent-5f7d568f6-6fc4k 1/1 Running 0 9s ack-cluster-agent-5f7d568f6-tf6fp 1/1 Running 0 9s
注册成功后,您可以在容器服务管理控制台的集群列表页面,看到该集群的状态为运行中。
执行结果
在集群列表页面中,找到对应的ACK One注册集群,单击操作列下的详情,查看新集群的基本信息和连接信息。
您可以使用该KubeConfig连接目标集群,进行应用负载的部署。关于连接集群的具体操作,请参见通过kubectl连接Kubernetes集群。
通过onectl创建ACK One注册集群并接入目标集群
安装配置onectl。具体操作,请参见通过onectl管理注册集群。
onectl支持通过以下两种方式创建ACK One注册集群。
重要在创建ACK One注册集群时,您需要输入VPC、vSwitch、Region等信息。
非交互式创建:执行以下命令,创建集群。
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
时,执行以下命令,将目标集群接入ACK One注册集群。onectl cluster connect --cluster-id **** --kubeconfig ~/.kube/config --restricted true
参数
是否必选
说明
cluster-id
是
上述步骤2中创建的ACK One注册集群的ID。
kubeconfig
否
目标集群的KubeConfig配置文件的路径。如未指定,将使用KUBECONFIG环境变量指向的配置文件。
restricted
否
是否以受限模式连接ACK One注册集群。更多信息,请参见注册集群ack-cluster-agent组件RBAC权限说明。
您还可以执行以下命令查看具体参数说明。
onectl cluster connect -h
执行以下命令,查看目标集群是否接入成功。
onectl cluster describe --cluster-id ****
预期输出:
name = test-registered-cluster state = running ...
预期输出表明集群状态为running,ACK One注册集群已经成功连接。