操作场景
创建好泳道后,我们需要配置灰度发布规则。延续泳道配置中的场景:假设当前访问链路为 gateway > consumer > provider。其中 consumer、provider 都有两个版本。希望通过请求参数 test = 1 时配置流量通过网关访问到 consumer、provider 的版本1中。
当前,gateway 以及 consumer、provider 的版本1 已经放在了泳道中,我们需要配置一条规则,当请求参数 test = 1时,流量到版本1的泳道中。
前提条件
已 创建服务泳道。
不支持创建子线程进行调用后的灰度发布。
新建灰度规则
1. 登录 腾讯微服务平台控制台。
2. 在左侧导航栏单击 TSF Consul,确认所选地域后,在页面上方选择 全链路灰度发布 页签,进入灰度发布页面。
3. 单击新建灰度规则,填写规则名称和备注。
规则名称:必填。支持中英文字符,不超过60字符。
标签:用于分类管理资源,可不选。详情参见 标签。
备注:选填。不超过200字符。
数据集:选填。用户可以通过数据集管理配置不同的子账号和协作者使用不同资源。详情参加数据集管理。
4. 单击下一步,填写请求参数规则和规则生效关系。

标签名:是 TSF 中的自定义标签,自定义标签是用户自定义的业务参数转换的 TSF 中使用的标签。 参数名最多32字节,参数值最多128字符。此处,我们配置标签名为 test,设置标签值为1。
自定义标签的来源有两种:
方式一:通过微服务网关将请求的参数转换为标签:如请求的 path、query、header 中包含的业务参数,通过微服务网关的 tag 插件转换为标签。详细使用说明可以参见 微服务网关 Tag 插件。
方式二:已在代码中配置标签,详细使用说明可以参见 参数传递。
逻辑关系:支持等于、不等于、包含、不包含、正则表达式五种逻辑关系。
选择等于和不等于时,标签值只能填写为单个值。
选择包含和不包含时,标签值可以填写多个,使用英文半角逗号分隔。
规则生效关系:上述条件的生效逻辑关系,或(满足任一规则)、与(满足全部规则)。每条全链路灰度规则最多包含10条子规则。
5. 单击下一步,配置流量目的地,选择已经创建好的泳道。


6. 单击完成。
切换灰度规则生效状态
在灰度发布页面,通过生效状态栏的按钮
调整规则是否生效。支持生效多条规则。

调整灰度规则优先级
全链路灰度发布支持同时生效多条规则,并支持为规则配置优先级。当同一条请求同时满足多条规则时,会优先匹配高优先级的规则。
在灰度发布页面,单击调整规则优先级,拖动规则名左侧的拖拽图标
,进行优先级配置,并单击保存。实际生效的优先级是生效状态的规则从页面上方向下的顺序进行排列的。

全链路灰度结果展示
在 腾讯微服务平台控制台的依赖分析 > 调用链查询中,用户可以查询对应的请求是否按照预期走到了泳道中。
1. 登录 腾讯微服务平台控制台。
2. 在左侧导航栏单击观测中心 > 调用链查询,进入调用链查询页面,确认当前所选地域后,根据需要选择 Trace 查询或 Span 查询。
3. 根据需求设置对应的查询过滤条件,如指定时间范围、指定 Trace/Span ID、指定服务或接口等,如果需要对标签和标签值进行过滤,可以输入标签和标签值,进行过滤。
4. 单击查询,页面将展示查询结果。
5. 单击每行结果中的ID、展开、查看调用详情、展开后的蓝/红色进度条等,可以查看更多查询结果细节。
全链路灰度流量流向规则与说明
当请求流量没有命中任何灰度规则,流量将走到没有被添加到泳道的部署组中。
当某一个微服务下的部署组没有被加入任何泳道中,请求将在该微服务下所有部署组的所有实例中轮询。经过该微服务后,请求将继续按照规则配置流入对应泳道。
举例:A > B > C 微服务调用,A 和 C 微服务下有版本1和版本2,B只有一个版本。配置灰度规则test = 1 的流量进入版本2对应的泳道后,流量将从 A 的版本2进入,经过 B 微服务,流入到 C 微服务的版本2中。
一个部署组可以属于多个泳道。
在泳道中,服务路由规则不生效。
泳道是一个隔离环境。当泳道上所有规则关闭后,流量不会进入泳道中。如希望恢复建立泳道前的流量分配方式,请将泳道删除。