导航
通过代理方式注册现有集群
最近更新时间：2024.12.10 14:41:44首次发布时间：2024.12.06 12:08:41
容器服务允许灵活接入和管理任何地域、基础设施上的 Kubernetes 集群。通过注册集群方式，将用户本地基础设施或其他云厂商的注册集群注册到容器服务进行统一管理，本文为您详细介绍如何通过代理方式接入集群。
说明
【邀测·申请试用】注册集群目前处于邀测阶段，如需使用，请提交申请。
背景信息
- 目前支持注册到容器服务的集群包括：阿里云 ACK、腾讯云 TKE、华为云 CCE、谷歌云 GKE、亚马逊云 EKS、百度云 CCE、自定义集群。
- 目前支持通过 代理模式 注册集群。适用于控制面无法直接访问目标集群，在控制面暴露代理服务地址，目标集群通过代理连接到控制面后进行统一管理的方式。
前提条件
- 已经准备待注册的集群，并确保能够正常登录到此集群中。
- 确保待注册集群中存在可用节点，否则无法正常导入代理配置，将导致注册集群连接断开。
使用限制
- 暂不支持接入 Windows 集群。
- 支持接入的 Kubernetes 集群的版本范围为：v1.24.x ~ v1.31.x。
- 若待注册集群中缺少可用节点，将无法正常导入代理配置；针对已经导入代理配置并成功连接的集群，下线所有节点将导致连接断开，直到重新获得可用节点。
- 建议至少保证集群内存在一个可以正常工作的节点，否则可能因为 Agent 安装失败，导致集群失联。详细介绍参见：常见问题。
操作步骤
注册现有集群分两步完成，先配置注册集群并获取代理配置，然后将配置导入源集群，即可完成集群接入。
步骤一：配置注册集群
- 登录 容器服务控制台。
- 在集群管理页面的左侧导航栏，选择 集群，进入集群管理页面。
- 单击左上角 注册集群，配置注册集群相关信息，完成后单击 下一步：配置确认。
| 配置项 | 说明 |
|---|---|
| 名称 | 自定义注册集群名称，命名规范：长度 2-64 个字符；支持英文字母、汉字、数字和中划线(-）。 |
| 连接方式 | 按实际情况选择导入集群的连接方式，本场景选择 代理模式。 |
| 云服务商 | 分布式云原生适配的第三方平台集群，要求选择与待接入集群匹配的云服务商，否则可能导致部分功能不可用。 |
| 集群描述 | 集群描述或备注信息。 |
标签 | 自定义添加集群标签，用于从不同维度对具有相同特征的集群进行分类、搜索和聚合，能够灵活管理集群。 说明 单击 添加标签 即可自定义添加集群标签，单个资源最多可以添加 50 个标签。 |
| 私有网络 | 待接入注册集群使用的私有网络。 |
| 子网 | 待接入注册集群使用的子网，使用该子网为集群 API Server 创建负载均衡。 |
| API Server 公网访问 | 默认关闭，若开启此配置，系统将自动创建 EIP（默认配置：BGP、10 Mbps、按量计费，可单击 更改 EIP 配置 按需更换） 并关联注册集群 API Server 负载均衡，即可通过公网连接管理注册集群。 |
| 集群删除保护 | 默认开启，用于保护集群，防止误删。开启后不允许通过控制台或调用 API 删除集群。 |
集群所属项目 | 项目管理是火山引擎提供的一种资源管理方式，可以对不同业务或项目使用的云资源进行分组管理。基于项目进行 IAM 授权，有利于维护资源独立、数据安全，同时可从项目维度查看资源消费账单，便于计算云资源使用成本。更多详细介绍参见：项目管理。 说明
|
- 配置确认无误后，阅读 《容器服务专用服务条款》 并勾选同意，单击 确定 ，将生成代理配置并返回注册集群列表页。此时，注册集群状态为 等待接入。
说明
配置确认步骤，将对账户状态、服务授权、产品配额进行前置检查。只有前置检查项全部通过后才能进行注册集群创建操作，若检查失败，需参考 详细信息 中的报错提示处理问题，然后重新执行注册集群创建操作。
步骤二：导入代理配置
获取注册集群访问凭证后，将代理配置保存在 Yaml 文件中，然后登录源集群运行 Yaml 即可导入代理配置。运行 Yaml 的方法有很多种，以各云服务厂商提供的方式为准。参考步骤如下：
- 在注册集群详情页的 连接信息 页签，按需获取公网或私网的代理配置，并保存在 Yaml 文件中。例如：
Agent.yaml。
- 前往源平台，针对待注册集群执行创建资源命令（例如：
kubectl apply -f Agent.yaml），导入代理配置。注册集群在容器服务的状态更换为 运行中 时，表示连接成功。