文档中心

API 网关

容器服务类型 Upstream

创建 VCI Agent Sandbox 服务类型 Upstream

API 网关支持对接 VCI Agent Sandbox，将容器集群 VCI 实例下的 Agent Sandbox Pod 抽象为一个 Upstream，作为网关的路由后端。适用于业务采用 Agent Sandbox 部署，希望通过网关按 Sandbox ID 动态发布业务的场景。本文为您介绍如何创建 VCI Agent Sandbox 类型 Upstream。

前提条件

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

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

已为 Agent Sandbox Pod 配置 Label，具体操作可参见将节点 Label/Annotation 注入到 Pod。

使用限制

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

操作步骤

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

在左侧导航栏实例管理下拉框中选择目标实例后，单击 Upstream 列表。

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

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

基本信息

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

后端配置

配置项	说明
后端服务	选择 Upstream 对接的后端服务类型。本场景选择 VCI Agent Sandbox。
监听范围	配置监听范围。全部 Sandbox：覆盖所选集群内全部 Sandbox。按 Label 选择：需输入 Sandbox Label 的 Key 与 Value，支持使用表格编辑和使用 JSON 格式编辑。

单击确定，完成配置。

结果验证

Upstream 实例创建成功后，您可在 Upstream 列表查看已创建的 VCI Agent Sandbox 类型 Upstream。

安全组配置

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

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

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

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

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

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

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

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

单击确定，完成配置。

最近更新时间：2026.08.13 11:28:47

这个页面对您有帮助吗？

有用

无用

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

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