对于注册中心 Nacos 类型 Upstream，通过 Nacos 服务的 metadata，配置不同的灰度版本，可以对注册中心内的服务进行灰度发布，进行多版本管理功能。 ## 背景信息注册中心类型 Upstream 版本是指在注册中心 Nacos 类型的 Upstream 中，基于 Nacos 服务的 metadata 划分出的灰度版本。每个 Upstream 版本对应 Nacos 服务中一组具有相同 metadata 标记的实例，用于在网关侧对同一后端服务的不同版本进行流量管理。 * **灰度发布**：将部分流量切换到新版本进行验证，确认无误后逐步扩大流量比例，实现平滑升级。 * **蓝绿部署**：同时运行两个版本的应用。蓝绿部署期间，将生产环境和预发布环境分别配置为不同的 Upstream 版本，通过切换路由权重实现零停机发布和快速回滚。如需了解 Upstream 版本在蓝绿发布、灰度发布场景下的端到端配置流程，可参见[通过控制台实现 Nacos 蓝绿部署和灰度发布](https://www.volcengine.com/docs/6569/1327344)。 ## 添加 Upstream 版本根据 Nacos 应用的 metadata，配置相应的灰度版本。 1. 登录 [API 网关控制台](https://console.volcengine.com/veapig)，在顶部导航栏，选择目标地域。 3. 在 **实例管理** 中选择目标实例后，单击 **Upstream 列表**。在 Upstream 列表页面，单击目标 Upstream 名称，进入当前 Upstream 概览页面。 3. 在灰度版本区域，单击 **新增灰度版本**。在弹出的新增灰度版本对话框中，设置版本信息。 |配置项 |说明 | |---|---| |版本名称 |自定义名称，用于标识该灰度版本。

* 名称长度限制为 2～63 个字符。

* 字符中只能包含大小写字母、数字和中划线`-`。

* 不能以中划线`-`开头。

* 同一 Upstream 下版本名称唯一。 | |标签 |填写当前版本在 Nacos 服务中对应的 metadata（key:value）。您需要根据实际业务的注册信息中选择一个键值对，作为划分当前版本的依据。一般存在于环境变量或 SDK 中。

注意

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

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

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

注意

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

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