有奖捉虫:行业应用 & 管理与支持文档专题 HOT
注册集群是腾讯云容器服务一种新的集群类型,可以将用户本地基础设施的 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-system
NAME READY STATUS RESTARTS AGE
clusternet-agent-78444974d7-f6fsc 1/1 Running 0 7m32s
clusternet-agent-78444974d7-qjp2q 1/1 Running 0 7m32s
clusternet-agent-78444974d7-r575w 1/1 Running 0 7m32s
注册成功后,注册集群的状态变为运行中,即表示集群注册成功。