文档中心

快速注册容器集群

最近更新时间：2024.04.26 15:28:58

首次发布时间：2023.07.20 10:49:32

分布式云原生平台允许灵活接入和管理任何地域、基础设施上的 Kubernetes 集群，本文为您介绍如何快速将容器集群接入分布式云原生平台。

背景信息

分布式云原生平台提供以下几种 Kubernetes 集群注册方式：

注册 VKE 集群：通过注册集群方式，将火山引擎 VKE 已有集群纳管到分布式云原生平台进行统一管理。
注册现有集群：通过注册集群方式，将用户本地基础设施或其他云厂商的容器集群注册到分布式云原生平台进行统一管理。

前提条件

注册火山引擎账号并完成实名认证，并前往分布式云原生控制台按照首次使用指引开通分布式云原生平台。
已经开通分布式云原生平台依赖的服务，例如：提供容器集群的容器服务、用于托管容器镜像的镜像仓库服务。

操作步骤

分布式云原生平台提供以下几种容器集群注册方式，可根据实际情况按需选择。

方式一：注册火山引擎 VKE 集群

通过注册集群方式，将火山引擎 VKE 的已有集群快速纳管到分布式云原生平台进行统一管理。

登录分布式云原生控制台。
在左侧导航栏选择 容器集群，进入容器集群管理页面。
单击容器管理页面顶部横幅中的 注册接入。
选择需要注册的集群，单击确定，即可将火山引擎 VKE 的已有集群纳管到分布式云原生平台进行统一管理。

alt

方式二：注册现有集群（代理方式）

通过代理方式注册集群，将用户本地基础设施或其他云厂商的容器集群注册到分布式云原生平台进行统一管理。

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

alt

配置项	说明
集群名称	自定义分布式云原生平台侧的集群名称，命名规范：长度 2-64 个字符；支持英文字母、汉字、数字和中划线(-）。
连接方式	按实际情况选择导入集群的连接方式，本场景选择代理连接。
云服务商	分布式云原生适配的第三方平台集群，包括：阿里云 ACK、华为云 CCE、腾讯云 TKE、谷歌云 GKE、亚马逊云 EKS、百度云 CCE、自定义集群。要求选择与待接入集群匹配的云服务商，否则可能导致部分功能不可用。
集群源地域	配置待注册集群在源平台所属的地域，例如：待注册阿里云 ACK 集群，在阿里云平台所属的地域为：`华北2（北京）`。该配置的作用类似标签，可用于集群筛选，关联项目或账单等，因此，建议配置真实地域。
集群描述	集群描述或备注信息。
标签	自定义添加集群标签，用于从不同维度对具有相同特征的集群进行分类、搜索和聚合，能够灵活管理集群。说明单击添加标签即可自定义添加集群标签，单个资源最多可以添加 50 个标签。
接入地域	容器集群接入分布式云原生平台后所属的地域。
私有网络	待接入容器集群使用的私有网络。
子网	待接入容器集群使用的子网，使用该子网为集群 API Server 创建负载均衡。
API Server 公网访问	默认关闭，若开启此配置，系统将自动创建 EIP（默认配置：BGP、10 Mbps、按量计费，可单击更改 EIP 配置按需更换）并关联主控实例 API Server 负载均衡，即可通过公网连接管理容器集群。
集群删除保护	默认开启，用于保护集群，防止误删。开启后不允许通过控制台或调用 API 删除集群。

配置确认无误后，阅读 《分布式云原生平台服务条款》 并勾选同意，单击确定，将生成代理配置并返回容器集群列表页。此时，容器集群状态为 等待接入。
在容器集群管理页面，单击目标集群名称，进入集群管理页面。在连接信息页签，按需获取公网或私网代理配置，并保存在 Yaml 文件中。例如：agent.yaml。
从集群所属原平台获取集群访问凭证，通过 kubectl 连接容器集群。
执行创建资源命令（例如：kubectl apply -f agent.yaml），将代理配置导入容器集群，容器集群状态更换为 运行中 时，即表示注册集群创建成功。

方式三：注册现有集群（直连方式）

通过直连方式注册集群，将用户本地基础设施或其他云厂商的容器集群注册到分布式云原生平台进行统一管理。

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

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 删除集群。

配置确认无误后，阅读 《分布式云原生平台服务条款》 并勾选同意，单击确定，开始校验信息并注册集群，系统会花费几分钟导入集群，完成后可在集群列表中查看导入的集群。