使用Apollo存储限流规则
Sentinel自身就支持了多种不同的数据源来持久化限流规则。Apollo是国内用户非常多的配置中心,所以,今天我们继续说说Spring Cloud Sentinel中如何将流控规则存储在Apollo中。
- 文件配置
- Nacos配置
- Zookeeper配置
- Apollo配置
本文我们来一起动手尝试一下,如何使用Apollo来存储限流规则。
准备工作
下面我们将同时使用到 Apollo 和 Sentinel Dashboard,所以可以把 Apollo 和 Sentinel Dashboard 启动起来。
如果还没入门 Apollo的,可以读一下Apollo官方文档
应用配置
第一步:在Spring Cloud 应用的 pom.xml 中引入Spring Cloud Alibaba的Sentinel 模块和Apollo存储扩展:
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>sentinel-datasource-apollo</artifactId>
<version>1.5.2</version>
</dependency>
</dependencies>
第二步:在Spring Cloud 应用中配置服务信息,在 resource 目录下,创建 apollo-env.properties 文件,内容样例:
local.meta=http://192.168.0.201:8080
dev.meta=http://192.168.0.202:8080
这里需要了解Apollo对多环境的配置,这里设置的是每个环境不同的配置服务地址,读者需要根据自己的实际情况修改。
第三步:在Spring Cloud 应用中添加配置信息:
spring.application.name=sentinel-datasource-apollo
server.port=8002
# apollo config
app.id=${spring.application.name}
# sentinel dashboard
spring.cloud.sentinel.transport.dashboard=localhost:8080
# sentinel datasource apollo
spring.cloud.sentinel.datasource.ds.apollo.namespaceName=application
spring.cloud.sentinel.datasource.ds.apollo.flowRulesKey=sentinel.flowRules
spring.cloud.sentinel.datasource.ds.apollo.rule-type=flow
- app.id:Apollo中创建的项目名称,这里采用 spring.application.name 参数的引用,从而达到服务名与配置项目名一致的效果。
- spring.cloud.sentinel.transport.dashboard:sentinel dashboard 的访问地址,根据上面的准备工作中启动的实例配置
- spring.cloud.sentinel.datasource.ds.apollo.namespaceName:Apollo的空间名
- spring.cloud.sentinel.datasource.ds.apollo.flowRulesKey:配置规则的key名称
- spring.cloud.sentinel.datasource.ds.apollo.rule-type:该参数是spring cloud alibaba 升级到0.2.2之后的配置,用来定义存储的规则类型。所有的规则类型可查看枚举类:org.springframework.cloud.alibaba.sentinel.datasource.RuleType,每种规则的定义格式可以通过各枚举值中定义的规则对象来查看,比如限流规则可查看:com.alibaba.csp.sentinel.slots.block.flow.FlowRule
关于Apollo相关配置的对应关系可见如下图所示:
第四步:创建应用主类,并提供一个rest接口,比如:
@EnableApolloConfig
@SpringBootApplication
public class TestApplication {
public static void main(String[] args) {
SpringApplication.run(TestApplication.class, args);
}
@Slf4j
@RestController
static class TestController {
@GetMapping("/hello")
public String hello() {
return "didispace.com";
}
}
}
其中,@EnableApolloConfig注解是开启Apollo的配置加载功能。
第五步:Apollo中配置限流规则,具体可见第三步的截图中的样子。其中,key值的内容是下面的JSON:
[
{
"resource": "/hello",
"limitApp": "default",
"grade": 1,
"count": 5,
"strategy": 0,
"controlBehavior": 0,
"clusterMode": false
}
]
可以看到上面配置规则是一个数组类型,数组中的每个对象是针对每一个保护资源的配置对象,每个对象中的属性解释如下:
- resource:资源名,即限流规则的作用对象
- limitApp:流控针对的调用来源,若为default则不区分调用来源
- grade:限流阀值类型(QPS或并发线程数);0代表根据并发数量来限流,1代表根据QPS来进行流量控制
- count:限流阀值
- strategy:调用关系限流策略
- controlBehavior:流量控制效果(直接拒绝、Warm up、匀速排队)
- clusterMode:是否为集群模式
这里我们只做简单配置的解释,以便于理解这里的配置作用。实际上这里还有非常多可配置的选项和规则,更复杂的配置后面我们单独开一篇来深入学习。
第六步:启动应用。如果一切顺利,可以看到类似下面的日志,代表已经成功从Nacos加载了一条限流规则:
2019-04-18 23:56:11.278 INFO 29149 --- [ main] o.s.c.a.s.c.SentinelDataSourceHandler : [Sentinel Starter] DataSource ds-sentinel-apollo-datasource start to loadConfig
2019-04-18 23:56:11.279 INFO 29149 --- [ main] o.s.c.a.s.c.SentinelDataSourceHandler : [Sentinel Starter] DataSource ds-sentinel-apollo-datasource load 1 FlowRule
通过 postman 或者 curl 访问几下 localhost:8002/hello接口:
$ curl localhost:8002/hello
didispace.com
此时,在Sentinel Dashboard中就可以看到当前我们启动的 sentinel-datasource-apollo 服务。点击左侧菜单中的流控控规则,可以看到已经存在了一条记录了,这条记录就是上面我们在Apollo中配置的限流规则。
深入思考
在使用Apollo存储规则配置的时候与Nacos存储一样,对于Sentinel控制台这些数据是只读的、也就是说:
- Sentinel控制台中修改规则:仅存在于服务的内存中,不会修改Apollo中的配置值,重启后恢复原来的值。
- Nacos控制台中修改规则:服务的内存中规则会更新,Apollo中持久化规则也会更新,重启后依然保持。
注:本文摘自程序猿DD-翟永超老师,我是亲自打字学习了解。