注册集群是腾讯云容器服务一种新的集群类型,可以将用户本地基础设施的 Kubernetes 集群或者其他云厂商的 Kubernetes 集群注册到腾讯云容器服务 TKE 统一管理。本文将介绍如何将第三方的 Kubernetes 集群注册到腾讯云容器服务 TKE。
前提条件
支持被注册的 K8s 集群版本范围:1.18.x ~ 1.24.5。超出此范围的 K8s 集群版本未经过验证,不保证支持该版本。
操作步骤
创建 Hub 集群
说明
注册集群属于 云原生分布式云中心(Tencent Kubernetes Engine Distributed Cloud Center, TDCC) 资源管理能力的重要组成部分,基于开源的 Clusternet 多集群应用治理项目实现。
在进行注册集群操作前,需要先创建 Hub Cluster,后续可通过该托管的 Hub Cluster 集群来管理其他注册进来的 Child Cluster 子集群。
1. 在 腾讯云控制台 中,选择云产品 > 云原生分布式云中心,进入云原生分布式云中心控制台,按照界面提示开通云原生分布式云中心服务并为服务授权。(如果您已为该服务授权,请跳过该步骤。)
2. 按照页面提示设置 Hub Cluster 的基本信息:
开通地域:选择 Hub Cluster 的地域,当前仅支持广州、北京和新加坡,未来会支持更多地域。
可用区:选择 Hub Cluster 的可用区。
集群网络:选择一个子网。 访问 Hub Cluster 的 kube-apiserver 需要使用弹性网卡,因此需要您提供 VPC 子网。TKE 会自动在选定的子网内创建代理弹性网卡。
注意:
创建 Hub Cluster 后接入地域及可用区无法更改。


创建注册集群
1. 登录 容器服务控制台,选择左侧导航栏中的注册集群。
2. 在注册集群管理的页面中,单击集群列表上方的注册已有集群。
3. 设置注册集群的基本信息:
集群名称:创建的注册集群名称,不超过60个字符。
接入地域:选择注册集群的接入地域,目前支持广州、北京和新加坡,未来会支持更多地域。
说明
接入地域与待注册集群的真实运行地域无关,它的含义是:管理此注册集群的Hub Cluster所在地域。
腾讯云标签:为集群绑定标签后可实现资源的分类管理。详情请参见 通过标签查询资源。
集群描述:填写集群的相关信息,该信息将显示在集群信息页面。
4. 单击完成,即可创建一个注册集群。您可以在注册集群列表,看到您创建的集群,集群的状态为等待注册,如下图:
说明:
您可以在集群列表,查看注册命令或者删除等待注册的集群。


执行注册命令
1. 在集群管理的页面,找到创建的注册集群,选择注册集群所在行右侧的查看注册命令,查看对应的注册命令。
2. 用户可以根据需要选择外网或者内网的方式注册集群,复制或者下载注册的命令,在第三方的集群中执行 kubectl 命令,完成注册的操作。
注意
注册命令的有效期为24小时,请在有效期内完成注册。如果超过有效期,则需要在页面上重新生成注册命令。
3. 执行以下命令查看代理运行状态,示例如下:
# kubectl get pod -n clusternet-systemNAME READY STATUS RESTARTS AGEclusternet-agent-78444974d7-f6fsc 1/1 Running 0 7m32sclusternet-agent-78444974d7-qjp2q 1/1 Running 0 7m32sclusternet-agent-78444974d7-r575w 1/1 Running 0 7m32s
注册成功后,注册集群的状态变为运行中,即表示集群注册成功。