概览

在使用 MSE 配置中心对业务集群配置进行集中管理时，如果对某个配置项进行了修改，新配置会覆盖旧配置并全量推送至集群。这种情况下，由于是全量推送，一旦配置出错，可能会影响整个业务集群。因此，在需要对配置进行修改发布时，推荐先进行灰度发布，让集群中一部分机器先收到新版本的配置内容，预先进行功能的验证，如果验证通过，再逐步扩大灰度，直至全量正式发布，降低配置变更风险；如果在灰度发布期间发现问题，可以立即停止灰度发布。本文介绍如何在 MSE 上进行配置灰度发布。

前提条件

1. 已创建 MSE 微服务引擎实例，详情参见 注册配置中心管理。
2. 已创建 命名空间，命名空间中已有 配置分组，配置分组中已有 配置文件。

概念解释

以下为本文档中涉及的概念及解释，在开始执行灰度发布操作之前，可先进行快速浏览以降低理解成本。

操作步骤

场景一：创建配置文件后直接灰度

功能入口：配置文件列表点击 发布-灰度发布

1. 登录 微服务引擎 MSE 控制台，并在顶部菜单栏选择地域。
2. 在左侧导航栏中选择 配置管理，在配置管理页面顶部 所属实例 中选择目标实例。
3. 在配置分组列表中点击目标配置分组名称进入二级页面。
4. 左侧导航栏选择 配置文件，在配置文件列表中找到目标配置文件，将鼠标移入操作列的 发布 后，点击 灰度发布。

5. 在灰度发布弹窗中根据自身业务需求选择灰度发布方式，支持 基于 IP 灰度发布 或 基于标签灰度发布 2 种方式。

   1. 若选择 基于 IP 灰度发布，则在应用节点 IP 中输入需要灰度发布的节点 IP 地址，支持输入多个，多个 IP 之间使用回车进行分隔。
   2. 若选择 基于标签灰度发布，则在应用节点标签中需要输入客户端标签。点击 添加标签 支持添加多个客户端标签。

   • 应用节点 IP 指订阅了该配置文件的机器 IP。
   • 基于标签灰度发布的“标签”是客户端标签，您可以在客户端对应用节点进行标签设置并针对标签进行灰度发布。

6. 确认无误后，点击下一步进入版本对比。在版本对比中右侧为本次灰度发布的内容，由于当前场景为配置文件创建后就灰度，因此左侧无使用中的正式版本。
7. 版本对比无误后点击弹窗右下角 灰度发布 执行灰度发布操作。说明：灰度版本无需输入版本号。
8. 灰度发布后在配置文件列表中原配置文件左侧会出现下拉箭头，点击箭头后即可看见配置文件的灰度版本，点击灰度版本的配置文件名可查看灰度版本详情。

场景二：正式版本需变更时灰度

1. 在配置文件列表中，找到需要变更的配置文件，点击操作列中编辑，在编辑配置文件弹窗中 开启配置灰度发布。

2. 在配置灰度发布模式中选择灰度发布方式，并配置对应灰度发布范围（IP/应用标签），在配置内容中更新需要灰度发布的内容，确认无误后点击右下角 灰度发布 进入版本对比。
3. 在版本对比中左侧为使用中正式版本内容，右侧为本次灰度发布内容，确认无误后点击弹窗右下角 灰度发布 执行灰度发布操作。

场景三：灰度版本需扩大灰度范围

1. 在配置文件列表中，找到需要更新的灰度版本，点击操作列中编辑，在编辑配置灰度版本弹窗中对相关内容进行更新，更新完成后点击右下角 灰度发布 进入版本对比。

2. 在版本对比中左侧为当前灰度中的内容，右侧为本次需要灰度发布的配置文件内容，确认无误后再次点击右下角 灰度发布，执行灰度发布操作。

   注意：重新灰度发布后，原灰度中的灰度版本将自动停止灰度并被删除。

场景四：灰度版本全量发布

1. 在配置文件列表中，找到需要全量发布的灰度版本，点击操作列中编辑，在编辑配置灰度版本弹窗中点击右下角 全量发布 进入全量发布配置。

2. 在全量发布弹窗中输入版本号、备注信息后点击 下一步 进入版本对比。

3. 在版本对比中左侧为使用中的正式版本内容，右侧为本次需要全量发布的配置文件内容，确认无误后点击右下角 全量发布 执行全量发布操作。

   注意：灰度版本全量发布后，当前灰度版本会自动停止灰度并删除。

场景五：停止灰度

1. 在配置文件列表中，找到需要停止灰度的灰度版本，点击操作列中停止灰度，在确认弹窗中点击 确定 即可完成停止灰度操作。