API 网关
API 网关
文档指南
请输入
- 文档首页
API 网关用户指南Upstream 管理Upstream 来源导入注册集群
复制全文
下载 pdf导入注册集群
文档反馈
问问助手API 网关支持基于容器服务的注册集群功能，将多云集群导入到 API 网关实例，将其作为网关的 Upstream 来源，以便网关获取集群中的 Service 列表。实现多云、多集群管理功能。本文介绍如何导入注册集群。
背景信息
容器服务支持注册集群功能，允许连接并管理不同地域、不同基础设施上的标准 Kubernetes 集群，纳管范围涵盖本地集群、第三方公有云集群、IDC 自建集群、边缘集群等满足 CNCF（Cloud Native Computing Foundation）标准的 Kubernetes 集群，例如：阿里云 ACK、腾讯云 TKE、华为云 CCE、谷歌云 GKE、亚马逊云 EKS、百度云 CCE、自定义集群。
API 网关通过对接注册集群功能，实现多集群管理能力。为多云、多集群提供托管的云原生网关功能，实现高可用、高扩展的 Ingress 流量管理方式。允许将集群中的 Service 资源添加为 API 网关的后端 Upstream，并支持配置路由权重。满足在多云容灾场景下业务发布、灰度发布等场景和需求。
API 网关导入注册集群，主要涉及以下场景：
- 对接火山引擎相同地域，不同 VPC 的多个托管集群。
- 对接火山引擎不同地域的多个托管集群。
- 对接多个云厂商的集群。
说明
前提条件
- 已创建 API 网关实例，详细操作请参见 创建实例。
- 已在容器服务控制台中，完成网络打通和集群导入。详情请参见 通过代理方式注册现有集群。
- 如果待导入的集群为火山引擎其他地域的 VKE 集群时，支持通过 云企业网 打通网络。
- 如果待导入的集群为非火山引擎 VKE 集群（其他云厂商集群、自建集群）时，支持通过 专线连接 打通网络。
- 已在待对接的集群中，完成工作负载和服务的部署。
使用限制
- 网关实例必须与导入集群在相同私有网络。
- 支持导入的 Kubernetes 集群的版本范围为：v1.24.x ~ v1.31.x。
说明
操作步骤
- 登录 API 网关控制台。
- 在顶部导航栏，选择目标地域。
- 在 实例管理 中选择目标实例后，单击 容器集群导入。
- 在导入集群页面，选择导入注册集群。
- 配置项说明K8S 集群选择具体要对接的导入集群。说明
- 仅支持选择与网关实例处于同一 VPC 下的集群。
- 仅支持选择状态为运行中的集群。
路由同步配置是否开启路由同步功能。开启路由同步后，API 网关会自动监听 Ingress 资源的变化，并生效 Ingress 资源中的相关配置，将 Ingress 资源转义为服务、自定义域名、路由、Upstream 等资源合并至当前网关。详细介绍请参见 Ingress 路由同步。
- 单击 确定，完成集群导入。
结果验证
集群导入后，在 集群列表 中查看导入集群状态，状态显示 导入成功 时，表示集群导入成功。
后续操作
最近更新时间：2025.11.18 11:46:33
这个页面对您有帮助吗？
有用
有用
无用
无用