You need to enable JavaScript to run this app.
文档中心
API 网关

API 网关

复制全文
下载 pdf
容器服务类型 Upstream
管理容器服务类型 Upstream 版本
复制全文
下载 pdf
管理容器服务类型 Upstream 版本
对于 VKE 类型 Upstream,支持根据工作负载在 VKE 侧的标签,配置不同的灰度版本,实现集群内和跨集群的流量管理,满足应用的多版本管理功能。​
背景信息​
同一 Upstream 可基于 Pod 标签划分多个灰度版本,每个版本绑定一组带专属标签的 Pod 实例,API 网关依据标签匹配规则,实现流量精准分发至对应版本。容器服务型 Upstream 版本,主要用于同一应用多版本灰度分流场景。​
  • 灰度发布:也称为金丝雀发布,是一种从旧版本平滑过渡到新版本的发布策略。该策略先上线一个新版本,从旧版本中切分一小部分线上流量到新版本,检验新版本在生产环境中的实际表现。新版本在环境中表现满足预期后,逐步加大流量分配比例,直至完全替代旧版本。​
  • 蓝绿部署:同时运行两个版本的应用。蓝绿部署期间,旧版本保持对外提供服务,等新版本运行起来后,再将流量全部切换至新版本。一般新版本与旧版本的资源规格保持一致,相当于该服务有两套完全相同的部署环境。新版本对外提供服务后,旧版本会作为热备。如果新版本上线后出现问题,可以迅速将流量切回旧版本,极大缩短故障恢复时间。​
如需了解 Upstream 版本在蓝绿发布、灰度发布场景下的端到端配置流程,可参见使用控制台实现容器服务应用的蓝绿发布和灰度发布和使用 Annotation 实现容器服务应用的蓝绿发布和灰度发布。​
添加 Upstream 版本​
说明​
添加 Upstream 版本前,需要先创建开启灰度版本的路由,操作方法参见 创建路由。​
根据工作负载在 VKE 侧的标签,配置相应的灰度版本。​
  1. 登录 API 网关控制台。​
  1. 在顶部导航栏,选择目标地域。​
  1. 在左侧导航栏 实例管理 下拉框中选择目标实例后,单击 Upstream 列表。​
  1. 在 Upstream 列表页面,单击目标 Upstream 名称,进入当前 Upstream 概览页面。​
  1. 在灰度版本区域,单击 新增灰度版本。在弹出的新增灰度版本对话框中,设置版本信息。​
  • ​
    配置项​
    说明​
    版本名称​
    自定义当前版本的名称,建议使用可读性强、语义明确的版本名称。同一 Upstream 下版本名称唯一。​
    标签​
    填写当前版本在 VKE 侧对应的标签(key:value)。您需要在 Deployment YAML的spec.template.metadata.labels参数中选择一个键值对,作为划分当前版本的依据。​
    注意​
    • 请务必保证标签的正确性。标签填写错误将导致流量无法转发至当前版本。​
    • 相同的标签仅支持配置一个灰度版本。​
    ​
  1. 单击 确定,完成灰度版本配置。​
编辑 Upstream 版本​
如果您在 VKE 侧修改了工作负载的标签,需要在网关侧同步修改当前灰度版本对应的标签。​
  1. 登录 API 网关控制台。​
  1. 在顶部导航栏,选择目标地域。​
  1. 在左侧导航栏 实例管理 下拉框中选择目标实例后,单击 Upstream 列表。​
  1. 在 Upstream 列表页面,单击目标 Upstream 名称,进入当前 Upstream 概览页面。​
  1. 在灰度版本表格中,选择要修改的灰度版本,单击 操作 列的 编辑 按钮。​
  1. 修改标签的键值对,修改完成后单击 确定。​
删除 Upstream 版本​
如果您在 VKE 侧配置的工作负载标签已废弃或删除,可删除当前灰度版本。​
注意​
删除灰度版本前,必须删除当前灰度版本关联的所有路由。​
  1. 登录 API 网关控制台。​
  1. 在顶部导航栏,选择目标地域。​
  1. 在左侧导航栏 实例管理 下拉框中选择目标实例后,单击 Upstream 列表。​
  1. 在 Upstream 列表页面,单击目标 Upstream 名称,进入当前 Upstream 概览页面。​
  1. 在灰度版本表格中,选择要删除的灰度版本,单击 操作 列的 删除 按钮。​
  1. 在弹出的二次确认框中,单击 删除,删除当前灰度版本。​
​
最近更新时间:2026.06.10 14:07:25
这个页面对您有帮助吗?
有用
有用
无用
无用