You need to enable JavaScript to run this app.
导航

注册现有集群(直连连接)

最近更新时间2024.04.26 15:28:56

首次发布时间2024.04.26 15:28:56

分布式云原生平台允许灵活接入和管理任何地域、基础设施上的 Kubernetes 集群,可通过注册集群方式,将用户本地基础设施或其他云厂商的容器集群注册到分布式云原生平台进行统一管理,本文为您详细介绍如何通过直连连接方式接入集群。

背景信息

常用的注册集群连接方式包括:直连连接、代理连接。

  • 直连连接:当控制面可以通过外网或在同一个私有网络中直接访问目标集群的 kube-apiserver 地址时, 通过目标集群提供的 KubeConfig 或 Token 进行直接注册管理的方式。
  • 代理连接:当控制面无法直接访问目标集群,可以在控制面暴露代理服务地址,目标集群通过代理连接到控制面后进行统一管理的方式。

前提条件

直连连接方式支持 导入 kubeconfig导入 Token 两种接入方式,可根据实际情况选择并提前准备以下内容:

  • 若使用导入 kubeconfig 接入方式,确保已经提前获取目标集群的 KubeConfig 配置,建议使用集群 admin 权限的 KubeConfig。获取方式参见:获取 kubeconfig
  • 若使用导入 Token 接入方式,确保已经提前获取目标集群的 Token 配置,获取方式参见:获取 Token
  • 确保待注册的现有集群和主控实例所在集群的网络互通,例如:待注册集群和当前集群处于同一个二层网络或待注册集群和当前集群已通过 VPN 或公网连通。

使用限制

  • 支持导入的 Kubernetes 集群的版本范围为:v1.17 ~ v1.27
  • 暂不支持注册 Windows 集群。
  • 通过直连连接方式注册腾讯云 TKE 集群到分布式云原生平台,存在访问不通的情况。详细介绍和解决方案参见:常见问题
  • 导入 Token 方式注册谷歌云 GKE 集群时,暂不支持 Autopilot 类型。

操作步骤

  1. 登录 分布式云原生控制台
  2. 在左侧导航栏选择 容器集群,进入容器集群管理页面。
  3. 单击 注册现有集群,进入现有集群注册页面。
  4. 在注册现有集群页面,配置注册集群相关信息,完成后单击 下一步:配置确认

alt

配置项说明
集群名称自定义分布式云原生平台侧的集群名称,命名规范:长度 2-64 个字符;支持英文字母、汉字、数字和中划线(-)。
连接方式按实际情况选择导入集群的连接方式,本场景选择 直连连接
云服务商分布式云原生适配的第三方平台集群,包括:阿里云 ACK、华为云 CCE、腾讯云 TKE、谷歌云 GKE、亚马逊云 EKS、百度云 CCE、自定义集群。要求选择与待接入集群匹配的云服务商,否则可能导致部分功能不可用。

集群源地域

配置待注册集群在源平台所属的地域,例如:待注册阿里云 ACK 集群,在阿里云平台所属的地域为:华北2(北京)
该配置的作用类似标签,可用于集群筛选,关联项目或账单等,因此,建议配置真实地域。

集群描述集群描述或备注信息。

标签

自定义添加集群标签,用于从不同维度对具有相同特征的集群进行分类、搜索和聚合,能够灵活管理集群。

说明

单击 添加标签 即可自定义添加集群标签,单个资源最多可以添加 50 个标签。

接入地域容器集群接入分布式云原生平台后所属的地域。

接入方式

提供 导入 kubeconfig导入 Token 两种注册集群导入方式,可根据实际情况按需选择。

  • 导入 kubeconfig:填写待导入集群的 KubeConfig,建议导入集群 admin 权限的 config。获取方式参见:获取 kubeconfig
  • 导入 Token:填写待导入集群的 Token 和 API Server 地址。Token 获取方式参见:获取 Token
集群删除保护默认开启,用于保护集群,防止误删。开启后不允许通过控制台或调用 API 删除集群。
  1. 配置确认无误后,阅读 《分布式云原生平台服务条款》 并勾选同意,单击 确定,开始校验信息并注册集群,系统会花费几分钟导入集群,完成后可在集群列表中查看导入的集群。

说明

配置确认步骤,将对账户状态、服务授权、产品配额进行前置检查。只有前置检查项全部通过后才能进行注册集群创建操作,若检查失败,需参考 详细信息 中的报错提示处理问题,然后重新执行注册集群创建操作。

alt