金丝雀发布是一种灰度发布策略，先上线一个新版本，从老版本中切分一小部分线上流量到新版本，检验新版本在生产环境中的实际表现。新版本在环境中表现满足预期后，逐步加大流量分配比例，直至完全替代旧版本。

前提条件

已创建两个或以上版本的 目标规则。

操作步骤

1. 登录规则配置页面。

   1. 登录 服务网格控制台。
   2. 在左侧导航栏，选择 服务治理 > 服务总览。
   3. 在服务管理列表中单击目标服务的名称。
   4. 点击 规则配置。

2. 在 灰度发布 > 金丝雀发布策略 页面，单击 开始创建。

3. 配置基本信息，配置完成后单击页面右下角 下一步：配置规则。

   名称	说明
   Virtual Service	虚拟服务的名称，可编辑，相同命名空间下虚拟服务需保持唯一。
   Host	虚拟服务流量的目标地址。在服务下创建的虚拟服务默认为服务本身。
   Gateway	虚拟服务是否仅对指定 Gateway 资源生效。在服务下创建的虚拟服务默认选择为 mesh，即整个服务网格下均生效。

4. 配置规则。
   

   名称	说明
   请求匹配	设定请求的匹配规则，允许符合规则的请求访问服务，支持通过 And 和 Or 的方式连接多个匹配规则。 简单模式 请求方法 Method：允许访问的方法（Method）。 全部 ：支持所有的请求方法 GET ：获取资源 POST：传输实体主体 PUT：传输文件 DELETE：删除文件 HEAD：获得首部字段 OPTIONS：询问支持的方法 CONNECT：要求用隧道协议连接代理 TRACE：追踪路径 LINK：建立和资源之间的联系 UNLINE：断开连接关系 路径 Path：允许访问的路径。 精准匹配：仅支持填写的路径访问服务。例如填写/feature， 仅支持 /feature 访问服务。 前缀匹配：支持包含指定前缀的路径访问服务。例如填写的前缀为 /feature，那么 /feature/version1和/feature/version2 都支持访问本服务。 正则匹配：支持通过正则表达式筛选允许访问服务的路径。 请求参数 QueryParams：允许包含了指定访问参数（QueryParams）的请求进行访问，访问参数不能为空，且不超过256个字符。 首部 Headers：只允许包含了指定首部字段（Headers）的请求进行访问。 高级模式 Path：允许访问的路径。 精准匹配：仅支持填写的路径访问服务。例如填写/feature， 仅支持 /feature 访问服务。 前缀匹配：支持包含指定前缀的路径访问服务。例如填写的前缀为 /feature，那么 /feature/version1和/feature/version2 都支持访问本服务。 正则匹配：支持通过正则表达式筛选允许访问服务的路径。 Scheme：允许访问的协议类型，支持 HTTP 和 HTTPS。 Method：允许访问的方法（Method）。 GET ：获取资源 POST：传输实体主体 PUT：传输文件 DELETE：删除文件 HEAD：获得首部字段 OPTIONS：询问支持的方法 CONNECT：要求用隧道协议连接代理 TRACE：追踪路径 LINK：建立和资源之间的联系 UNLINE：断开连接关系 Domain：允许访问的目标服务器地址，地址不能为空，且不超过 256 个字符。 QueryParams：允许包含了指定访问参数（QueryParams）的请求进行访问，访问参数不能为空，且不超过 256 个字符。 Headers：只允许包含了指定首部字段（Headers）的请求进行访问。 WithoutHeaders：不允许任何包含了指定禁用首部字段（WithoutHeaders）的请求进行访问。
   分流规则	选择目标规则中定义的服务版本（subset）以及每个版本对应的流量权重，通过调整流量权重可以实现灰度发布。默认创建权重为 99% 和 1% 的两条分流规则。 服务：支持选择内部服务和外部服务，外部负载需要选择服务本身。 端口：1 ~ 65535 的正整数。 服务版本：服务实例的子集，在目标规则中定义。 权重： 当前版本的流量权重，所有版本的权重之和需要为 100。

5. （可选）添加高级配置。

   名称	说明
   超时	设置超时时间，支持设置的时长单位包括毫秒（ms）、秒（s）、分钟（m）和小时（h）。
   故障注入	在系统中人为的设置故障，以测试系统的稳定性和系统恢复的能力。可以配置延时或错误码的方式进行故障注入。 延时：设定注入固定的延时时间和延时注入百分比。 错误码：设置返回特定的 HTTP 错误码和错误注入百分比。
   重试	重试用来解决网络抖动时通信失败的问题，提高系统的可用性。 重试次数：每次请求的最大重试次数。 重试超时时间：每次重试尝试超时时间。
   重定向	重定向是当一个页面或一个 Web 应用被迁移到新的域名或 Path 后，保持原有链接可用的方式。 重定向 Path：替换 URL 中的 Path 部分，重定向 Path 的配置会替换原请求中的完整 Path，而不是匹配条件上的 Path 部分。 重定向 Domain：替换 URL 中的 Domain 部分，例如域名或 Host。 重定向 Code：设置请求返回 Code，默认值 301。
   重写	通过 HTTP 重写可以将请求转发给目标服务前修改 HTTP 请求中指定部分的内容，不同于重定向的是，HTTP 重写对用户不可见。 重写 Path：重写 URL 中的 Path 部分，如果原来匹配条件是前缀匹配，则重写后只修改匹配到的前缀。 重写 Domain：：重写 URL 中的 Domain 部分，例如域名或 Host。
   流量镜像	流量镜像又叫影子流量，通过复制一份请求并把它发送到镜像服务，从而实现流量的复制。 服务版本：指定流量复制的目标版本，目前支持复制到当前服务的特定版本。 百分比：流量复制的百分比。
   跨域	当一个资源向该资源所在服务器的不同的域发起请求时，产生一个跨域的 HTTP 请求。出于安全考虑，浏览器会限制从脚本发起的跨域 HTTP 请求。 来源（AllowedOrigin）：指定允许的跨域请求的来源。支持添加多行。匹配方式：精准匹配（exact）、前缀匹配（prefix）、正则匹配（regex）。 允许 Methods：指定允许的跨域请求方法。 选择框内容：GET、POST、PUT、DELETE、HEAD。 允许 Headers：指定允许跨域请求的响应头。支持输入多行、以回车换行。 暴露 Headers：指定允许用户从应用程序中访问的响应头。支持输入多行、以回车换行。 缓存时间：指定浏览器对特定资源的预取（OPTIONS）请求返回结果的缓存时间。

6. 完成所有配置后，单击页面底部的 确定。