Spring Cloud Gray 管控端界面使用手册

设置实例的灰度策略

场景

设置service-a的ip为192.168.0.10的实例为灰度实例，并设置灰度策略version = 2.1.0

效果

url参数version等于2.1.0的请求，都将被转到192.168.0.10这台实例上

操作

第一步-添加服务

进入服务列表，点击左上角的Add按钮，添加服务信息。ServiceId为必填，并且serviceId的值需要与服务的spring.application.name一致(区分大小写)

第二步-添加灰度实例

添加灰度实例，在服务列表，点击service-a那一行的在线实例按钮，打开service-a的在线实例列表，选中ip为192.168.0.10的那台实例，然后点击Add按钮，把实例添加为灰度实例。

第三步-设置灰度追踪

设置灰度追踪的目的是为了将用户请求的最初信息透传到服务链，比如version参数能够从网关一直透传到后面的服务中。

操作步骤：服务列表 -> 追踪按钮(从网关服务进) -> 灰度追踪列表 点击左上角的Add按钮，弹出添加面板，输入追踪类型(Name)和追踪字段(Infos)。

• Name: HttpParameter
• Infos: version

Infos可以追踪多个字段，多个字段用逗号(,)分隔

更多的灰度追踪配置可以查看后面的灰度追踪格式

第四步-设置灰度策略

设置灰度策略，需要添加灰度策略以及灰度决策。进入灰度策略列表的操作步骤：服务列表 -> 实例按钮 -> 灰度实例列表 -> 策略按钮 -> 灰度策略列表。

点击左上角的Add按钮，弹出添加面板，输入策略标识(Alias)，这个字段由用户自定义。

然后再为这个策略添加灰度决策，步骤是: 灰度策略列表 -> 决策按钮 -> 灰度决策列表

同样是点击左上角的Add按钮，弹出添加面板，输入灰度决策名称(Name)，和灰度决策条件(Infos);

如设置version等于2.1.0的请求，都将被转到这台实例上

• Name: HttpTrackParameter
• Infos: {"name":"version","compareMode":"EQUAL","values":"2.1.0"}

更多的灰度决策配置可以查看后面的灰度决策格式

修改实例的灰度状态

操作步骤

服务列表 -> 实例按钮 -> 灰度实例列表 -> Edit按钮

以上操作是打开灰度实例的信息面板，修改Gray Status字段，该字段有两个选项：OPEN, CLOSE，分别对应打开和关闭，修改完成后，点击保存即可。

灰度状态的作用

灰度状态是用来控制实例是否灰度，当灰度状态打开时，只有匹配该实例的任意灰度策略的请求，才会被转发到该实例上。

灰度锁定

操作步骤

服务列表 -> 实例按钮 -> 灰度实例列表 -> Edit按钮

以上操作是打开灰度实例的信息面板，修改Gray Lock字段，该字段有两个选项：LOCK, UNLOCK，分别对应锁定和非锁定，修改完成后，点击保存即可。

灰度锁定的作用

灰度锁定是为了当灰度状态为打开时，即使实例的状态为DOWN(非正常状态)了，其它的灰度客户端也能从管控端获取到该实例的灰度信息。 这样在发布过程，发布实例的灰度信息不会因为实例状态的变动而导致其它灰度客户端获取不到该发布实例的灰度信息，造成正常请求被转发到该发布实例上。

灰度决策的格式

在度决策

HttpHeaderGrayDecisionFactory Name: HttpHeader
Infos: {"compareMode":"EQUAL","header":"headerName","values":"headerValue"}
Class: cn.springcloud.gray.decision.factory.HttpHeaderGrayDecisionFactory
Describe: 根据http请求头的字段进行判断

HttpMethodGrayDecisionFactory Name: HttpMethod
Infos: {"compareMode":"EQUAL","method":"POST"}
Class: cn.springcloud.gray.decision.factory.HttpMethodGrayDecisionFactory
Describe: 根据http请求方法的字段进行判断

HttpParameterGrayDecisionFactory Name: HttpParameter
Infos: {"compareMode":"EQUAL","name":"paramName","values":"paramValue"}
Class: cn.springcloud.gray.decision.factory.HttpParameterGrayDecisionFactory
Describe: 比对http url参数

HttpTrackHeaderGrayDecisionFactory Name: HttpTrackHeader
Infos: {"compareMode":"EQUAL","header":"headerName","values":"headerValue"}
Class: cn.springcloud.gray.decision.factory.HttpTrackHeaderGrayDecisionFactory
Describe: 根据灰度追踪记录的http请求头的字段进行判断

HttpTrackParameterGrayDecisionFactory Name: HttpTrackParameter
Infos: {"compareMode":"EQUAL","name":"paramName","values":"paramValue"}
Class: cn.springcloud.gray.decision.factory.HttpTrackParameterGrayDecisionFactory
Describe: 根据灰度追踪记录的http url参数进行判断

TraceIpGrayDecisionFactory Name: TraceIp
Infos: {"ip":"192\.168\.0\.*"}
Class: cn.springcloud.gray.decision.factory.TraceIpGrayDecisionFactory
Describe: 根据灰度追踪记录的请求ip进行判断, ip可以是正常表达式

TrackAttributeGrayDecisionFactory Name: TrackAttribute
Infos: {"compareMode":"EQUAL","name":"attributeName","values":"attributeValue"}
Class: cn.springcloud.gray.decision.factory.TrackAttributeGrayDecisionFactory
Describe: 根据灰度追踪记录的属性值进行判断

FlowRateGrayDecisionFactory Name: FlowRate
Infos: {"type":"TrackAttribute","field":"userid","salt":"","rate":"10"}
Class: cn.springcloud.gray.decision.factory.FlowRateGrayDecisionFactory
Describe: 指定字段按百分比放量进行判断

CompareMode

比较模式，共有6种

灰度追踪的格式