对于 VKE 类型 Upstream，支持根据工作负载在 VKE 侧的标签，配置不同的灰度版本，实现集群内和跨集群的流量管理，满足应用的多版本管理功能。 ## 背景信息同一 Upstream 可基于 Pod 标签划分多个灰度版本，每个版本绑定一组带专属标签的 Pod 实例，API 网关依据标签匹配规则，实现流量精准分发至对应版本。容器服务型 Upstream 版本，主要用于同一应用多版本灰度分流场景。 * **灰度发布**：也称为金丝雀发布，是一种从旧版本平滑过渡到新版本的发布策略。该策略先上线一个新版本，从旧版本中切分一小部分线上流量到新版本，检验新版本在生产环境中的实际表现。新版本在环境中表现满足预期后，逐步加大流量分配比例，直至完全替代旧版本。 * **蓝绿部署**：同时运行两个版本的应用。蓝绿部署期间，旧版本保持对外提供服务，等新版本运行起来后，再将流量全部切换至新版本。一般新版本与旧版本的资源规格保持一致，相当于该服务有两套完全相同的部署环境。新版本对外提供服务后，旧版本会作为热备。如果新版本上线后出现问题，可以迅速将流量切回旧版本，极大缩短故障恢复时间。如需了解 Upstream 版本在蓝绿发布、灰度发布场景下的端到端配置流程，可参见[使用控制台实现容器服务应用的蓝绿发布和灰度发布](https://www.volcengine.com/docs/6569/605027?lang=zh)和[使用 Annotation 实现容器服务应用的蓝绿发布和灰度发布](https://www.volcengine.com/docs/6569/1275023?lang=zh)。 ## 添加 Upstream 版本

说明

添加 Upstream 版本前，需要先创建开启灰度版本的路由，操作方法参见创建路由。

根据工作负载在 VKE 侧的标签，配置相应的灰度版本。 1. 登录 [API 网关控制台](https://console.volcengine.com/veapig)。 2. 在顶部导航栏，选择目标地域。 3. 在左侧导航栏 **实例管理** 下拉框中选择目标实例后，单击 **Upstream 列表**。 4. 在 Upstream 列表页面，单击目标 Upstream 名称，进入当前 Upstream 概览页面。 5. 在灰度版本区域，单击 **新增灰度版本**。在弹出的新增灰度版本对话框中，设置版本信息。 |配置项 |说明 | |---|---| |版本名称 |自定义当前版本的名称，建议使用可读性强、语义明确的版本名称。同一 Upstream 下版本名称唯一。 | |标签 |填写当前版本在 VKE 侧对应的标签（key:value）。您需要在 Deployment YAML的`spec.template.metadata.labels`参数中选择一个键值对，作为划分当前版本的依据。

注意

请务必保证标签的正确性。标签填写错误将导致流量无法转发至当前版本。

相同的标签仅支持配置一个灰度版本。

| 4. 单击 **确定**，完成灰度版本配置。 ## 编辑 Upstream 版本如果您在 VKE 侧修改了工作负载的标签，需要在网关侧同步修改当前灰度版本对应的标签。 1. 登录 [API 网关控制台](https://console.volcengine.com/veapig)。 2. 在顶部导航栏，选择目标地域。 3. 在左侧导航栏 **实例管理** 下拉框中选择目标实例后，单击 **Upstream 列表**。 4. 在 Upstream 列表页面，单击目标 Upstream 名称，进入当前 Upstream 概览页面。 5. 在灰度版本表格中，选择要修改的灰度版本，单击 **操作** 列的 **编辑** 按钮。 6. 修改标签的键值对，修改完成后单击 **确定**。 ## 删除 Upstream 版本如果您在 VKE 侧配置的工作负载标签已废弃或删除，可删除当前灰度版本。

注意

删除灰度版本前，必须删除当前灰度版本关联的所有路由。

1. 登录 [API 网关控制台](https://console.volcengine.com/veapig)。 2. 在顶部导航栏，选择目标地域。 3. 在左侧导航栏 **实例管理** 下拉框中选择目标实例后，单击 **Upstream 列表**。 4. 在 Upstream 列表页面，单击目标 Upstream 名称，进入当前 Upstream 概览页面。 5. 在灰度版本表格中，选择要删除的灰度版本，单击 **操作** 列的 **删除** 按钮。 6. 在弹出的二次确认框中，单击 **删除**，删除当前灰度版本。