文档中心

API 网关

容器服务类型 Upstream

创建容器服务类型 Upstream

API 网关支持对接火山引擎容器服务 VKE，将 VKE 集群下的 Kubernetes Service 抽象为一个 Upstream，作为网关的路由后端。适用于业务采用 VKE 部署，希望通过网关发布业务的场景。本文为您介绍如何创建 VKE 类型 Upstream。

前提条件

已创建 API 网关实例，具体操作可参见创建实例。

已将待对接集群添加为 Upstream 来源，具体操作可参见导入 VKE 集群。

使用限制

API 网关实例与容器服务集群必须处于同一 VPC 下。

操作步骤

在顶部导航栏，选择目标地域。

在实例管理中选择目标实例后，单击 Upstream 列表。

在 Upstream 列表页面，单击创建 Upstream。

在创建 Upstream 页面，按要求填写参数信息。

基本信息

配置项
说明
Upstream 名称
自定义 Upstream 名称，同一实例下的 Upstream 名称唯一。

后端配置

配置项	说明
后端服务	选择 Upstream 对接的后端服务类型。本场景选择容器服务。API 网关会自动聚合 Upstream 来源中所有集群下的同名 Namespace、Service 及 Port，将其看作一个应用。命名空间：选择目标 Kubernetes Service 所在的命名空间。服务名称：选择目标 Kubernetes Service 名称。端口：选择目标 Kubernetes Service 开放的端口。
协议	选择协议类型。支持 HTTP1.1、HTTP2 和 HTTP2/GRPC。
TLS 设置	配置 TLS。关闭 TLS：网关访问后端 Upstream 使用 HTTP 协议。单向 TLS：网关访问后端 Upstream 使用 HTTPS 协议，需要选择对应证书。
负载均衡算法	配置负载均衡算法。轮询：（默认）将所有请求依次分发到 Kubernetes Service 关联的各个 Pod，适合 Pod 规格相同的场景。随机：请求随机分配到各个 Pod。最小连接数：将请求分配到目前处理请求数最少的 Pod。一致性哈希：基于 header/querystring 信息进行负载均衡，在后端服务数量不变的情况下，确保携带信息相同的用户可固定访问同一 Pod。支持单击启用过载保护，设置负载阈值，开启实例过载保护。开启后，若实例活跃请求数超过平均活跃请求数的阈值，即便 Hash 值命中该实例，也不会选择该实例。
服务熔断	配置是否开启熔断。开启后，API 网关可以通过设置熔断器以提高路由的命中率，不消耗额外流量。详情请参见服务熔断策略。
预热时间	当负载均衡算法配置为轮询或最小连接数时，支持配置。配置后端服务预热时间。整数形式，取值范围为 1～10000，不包含 10000，单位为秒。

单击确定，完成配置。

安全组配置

当 API 网关对接 VPC-CNI 集群时，默认已放行，无需执行放行操作。

当 API 网关对接 Flannel 集群时，需要为待对接 Flannel 集群下的所有节点开放 APIG 安全组（命名为apig-sg-<accountID>），确保网关可以正常访问集群中的资源。容器服务中所有节点均绑定了命名为<集群ID>-common的默认安全组，您只需在默认安全组中添加一条入规则，放行 APIG 安全组。具体操作如下：

登录容器服务控制台，在左侧导航栏选择集群，在集群列表页面单击目标 Flannel 集群，进入当前集群管理页面。

在左侧导航栏选择节点，在节点列表页面单击任一节点名称，进入当前节点详情页面。

在基本信息区域，寻找命名为<集群ID>-common的容器服务默认安全组，并单击进入当前安全组。

切换至访问规则页签，在入向规则区域单击添加规则。

在添加入方向规则对话框，按要求配置 APIG 安全组信息。表格中未提到的参数保持默认配置。

配置项
说明
协议类型
选择 ALL ，允许所有通信协议的访问。
源地址
选择安全组，选择命名为apig-sg-<accountID>的 APIG 安全组。

单击确定，完成配置。

最近更新时间：2025.11.18 11:46:32

这个页面对您有帮助吗？

有用

无用

配置项	说明
Upstream 名称	自定义 Upstream 名称，同一实例下的 Upstream 名称唯一。

配置项	说明
协议类型	选择 ALL ，允许所有通信协议的访问。
源地址	选择安全组，选择命名为apig-sg-<accountID>的 APIG 安全组。