API 网关支持基于容器服务的注册集群功能，将多云集群导入到 API 网关实例，将其作为网关的 Upstream 来源，以便网关获取集群中的 Service 列表。实现多云、多集群管理功能。本文介绍如何导入注册集群。 ## 背景信息容器服务支持注册集群功能，允许连接并管理不同地域、不同基础设施上的标准 Kubernetes 集群，纳管范围涵盖本地集群、第三方公有云集群、IDC 自建集群、边缘集群等满足 CNCF（Cloud Native Computing Foundation）标准的 Kubernetes 集群，例如：阿里云 ACK、腾讯云 TKE、华为云 CCE、谷歌云 GKE、亚马逊云 EKS、百度云 CCE、自定义集群。注册集群允许用户灵活接入和管理任何地域、基础设施上的 Kubernetes 集群，并提供统一管理和统一运维管控，避免业务方直接对接多云，高效管理。更多注册集群详情，请参见 [注册集群概述](https://www.volcengine.com/docs/6460/1374026)。 API 网关通过对接注册集群功能，实现多集群管理能力。为多云、多集群提供托管的云原生网关功能，实现高可用、高扩展的 Ingress 流量管理方式。允许将集群中的 Service 资源添加为 API 网关的后端 Upstream，并支持配置路由权重。满足在多云容灾场景下业务发布、灰度发布等场景和需求。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9212d4b2cc5600844263aafd52d52559.png =646x) API 网关导入注册集群，主要涉及以下场景： * 对接火山引擎相同地域，不同 VPC 的多个托管集群。 * 对接火山引擎不同地域的多个托管集群。 * 对接多个云厂商的集群。 :::tip API 网关对接火山引擎相同地域，相同 VPC 的多个托管集群，可以使用导入托管集群功能。详情请参见 [导入容器集群](https://www.volcengine.com/docs/6569/133830)。 ::: ## 前提条件 * 已创建 API 网关实例，详细操作请参见 [创建实例](https://www.volcengine.com/docs/6569/85693)。 * 已在容器服务控制台中，完成网络打通和集群导入。详情请参见 [通过代理方式注册现有集群](https://www.volcengine.com/docs/6460/1364447)。 * 如果待导入的集群为火山引擎其他地域的 VKE 集群时，支持通过 [云企业网](https://www.volcengine.com/docs/6405/68182) 打通网络。 * 如果待导入的集群为非火山引擎 VKE 集群（其他云厂商集群、自建集群）时，支持通过 [专线连接](https://www.volcengine.com/docs/6407/68176) 打通网络。 * 已在待对接的集群中，完成工作负载和服务的部署。 ## 使用限制 * 网关实例必须与导入集群在相同私有网络。 * 支持导入的 Kubernetes 集群的版本范围为：**v1.24.x ~ v1.31.x**。 :::tip 更多导入集群限制，请参见 [通过代理方式注册现有集群](https://www.volcengine.com/docs/6460/1364447)。 ::: ## 操作步骤 1. 登录 [API 网关控制台](https://console.volcengine.com/veapig)。 2. 在顶部导航栏，选择目标地域。 3. 在 **实例管理** 中选择目标实例后，单击 **容器集群导入**。 4. 在导入集群页面，选择导入注册集群。 |配置项 |说明 | |---|---| |K8S 集群 |选择具体要对接的导入集群。|\ | |:::tip|\ | ||\ | |* 仅支持选择与网关实例处于同一 VPC 下的集群。|\ | |* 仅支持选择状态为运行中的集群。|\ | ||\ | |:::| |路由同步 |配置是否开启路由同步功能。|\ | |开启路由同步后，API 网关会自动监听 Ingress 资源的变化，并生效 Ingress 资源中的相关配置，将 Ingress 资源转义为服务、自定义域名、路由、Upstream 等资源合并至当前网关。详细介绍请参见 [Ingress 路由同步](https://www.volcengine.com/docs/6569/1121950)。 | 6. 单击 **确定**，完成集群导入。 ## 结果验证集群导入后，在 **集群列表** 中查看导入集群状态，状态显示 **导入成功 ** 时，表示集群导入成功。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_33175fa9d6bf613cf912aa35f21d2602.png =944x) ## 后续操作 * [集群路由同步](https://www.volcengine.com/docs/6569/1121950) * [创建容器服务类型 Upstream](https://www.volcengine.com/docs/6569/129949)