- 删除项目中application.properties中的配置后重启项目访问http://localhost:7000/coupon/coupon/test仍可以获取数据
- 在controller上,添加
@RefreshScope
注解,即可实现动态刷新。
- 如果想要修改,在nacos配置列表中对配置进行编辑即可。
访问地址也可动态实时刷新,获取最新数据。
Nacos Config数据结构
Nacos Config 主要通过 dataId 和 group 来唯一确定一条配置。
Nacos Client 从 Nacos Server 端获取数据时,调用的是此接口 ConfigService.getConfig(String dataId, String group, long timeoutMs)。
Spring Cloud 应用获取数据
dataID:
在 Nacos Config Starter 中,dataId 的拼接格式如下
- prefix−{prefix} - {spring.profiles.active} . ${file-extension} prefix 默认为 spring.application.name
的值,也可以通过配置项 spring.cloud.nacos.config.prefix 来配置。
- spring.profiles.active 即为当前环境对应的 profile
注意,当 activeprofile 为空时,对应的连接符 - 也将不存在,dataId 的拼接格式变成
p r e f i x . {prefix}. prefix.{file-extension}
file-extension 为配置内容的数据格式,可以通过配置项spring.cloud.nacos.config.file-extension 来配置。 目前只支持 properties 类型。
Group:
Group 默认为 DEFAULT_GROUP,可以通过 spring.cloud.nacos.config.group 配置。
- 在应用中使用@Value 和@RefreshScope
完成上述两步后,应用会从 Nacos Config 中获取相应的配置,并添加在 Spring Environment 的 PropertySources 中 。 这 里 我 们 使 用 @Value 注 解 来 将 对 应 的 配 置 注 入 到SampleController 的 userName 和 age 字段,并添加 @RefreshScope 打开动态刷新功能
@RefreshScope class SampleController { @Value(“${user.name}”) String userName; @Value(“${user.age}”) int age; }
- 如何使用Nacos作为配置中心统一管理配置
- 引入
spring-cloud-starter-alibaba-nacos-config
依赖 - 创建
bootstrap.properties
并配置应用名和Nacos配置中心地址(前提:启动Nacos服务器) - 需要给配置中心默认添加一个叫数据集(Data Id)gulimall-coupon.properties。
默认规则:应用名.properties
- 给应用名.properties添加配置
- 动态获取配置
使用注解@RefreshScope
:动态获取并刷新配置
使用注解@Value("${配置项的名}")
:获取配置
如果配置中心和当前应用的配置文件中都配置了相同的项,优先使用配置中心的配置。
- 进阶
- 核心概念
| 名称 | 解释 |
| — | — |
| 命名空间 | 用于进行租户粒度的配置隔离。不同的命名空间下,可以存在相同的 Group 或 Data ID 的配置。Namespace 的常用场景之一是不同环境的配置的区分隔离,例如开发测试环境和生产环境的资源(如配置、服务)隔离等。 |
| 配置集 | 一组相关或者不相关的配置项的集合称为配置集。在系统中,一个配置文件通常就是一个配 置集,包含了系统各个方面的配置。例如,一个配置集可能包含了数据源、线程池、日志级别等配置项。 |
| 配置集 ID | Nacos 中的某个配置集的 ID。配置集 ID 是组织划分配置的维度之一。Data ID 通常用于组织划分系统的配置集。一个系统或者应用可以包含多个配置集,每个配置集都可以被一个有意义的名称标识。Data ID 通常采用类 Java 包(如 com.taobao.tc.refund.log.level)的命名规则保证全局唯一性。此命名规则非强制。 |
| 配置分组 | Nacos 中的一组配置集,是组织配置的维度之一。通过一个有意义的字符串(如 Buy 或Trade )对配置集进行分组,从而区分 Data ID 相同的配置集。当您在 Nacos 上创建一个配置时,如果未填写配置分组的名称,则配置分组的名称默认采用 DEFAULT_GROUP 。配置分组的常见场景:不同的应用或组件使用了相同的配置类型,如 database_url 配置和MQ_topic 配置。 |
- 命名空间:配置隔离
默认:public(保留空间);默认新增的所有配置都在public空间。
举例:
- 利用命名空间做环境隔离
注意:在bootstrap.properties中配置使用哪一个命名空间,使用命名空间id进行标识
- 开发、测试、生产环境均有不同配置。可以新建不同命名空间。
- 可以在不同命名空间下创建相同配置
gulimall-coupon.properties
- 服务启动后,默认会寻找public命名空间下的配置。可以在
bootstrap.properties
中配置使用不同命名空间
spring.cloud.nacos.config.namespace=命名空间id
- 服务重启后,可以访问到dev中的配置
- 基于每一个微服务之间互相隔离配置,每一个微服务都创建自己的命名空间,只加载自己命名空间下的配置。
- 配置集:所有配置的集合
- 配置集ID:类似文件名
Data ID:配置文件名。
- 配置分组:
默认所有的配置集都属于:DEFAULT_GROUP
。新建配置的时候可以指定不同的配置分组。
可以在配置文件中对使用哪一个配置分组进行指定
spring.cloud.nacos.config.group=1111
- 项目里的使用namespace 与group 最佳实践
- 每个微服务创建自己的命名空间(namespace)进行隔离
- 使用配置分组(group )区分环境。(dev/test/prod等)
- 通过修改
bootstrap.properties
控制使用不同的命名空间。
- 原理
- 自动注入
NacosConfigStarter 实现了 org.springframework.cloud.bootstrap.config.PropertySourceLocator接口,并将优先级设置成了最高。
在 Spring Cloud 应用启动阶段,会主动从 Nacos Server 端获取对应的数据,并将获取到的数据转换成 PropertySource 且注入到 Environment 的PropertySources 属性中,所以使用@Value 注解也能直接获取 Nacos Server 端配置的内容。
- 动态刷新
Nacos Config Starter 默认为所有获取数据成功的 Nacos 的配置项添加了监听功能,在监听到服务端配置发生变化时会实时触发org.springframework.cloud.context.refresh.ContextRefresher 的 refresh 方法 。
如果需要对 Bean 进行动态刷新,请参照 Spring 和 Spring Cloud 规范。推荐给类添加@RefreshScope 或 @ConfigurationProperties 注解
- 加载多配置文件
spring.cloud.nacos.config.server-addr=127.0.0.1:8848 spring.cloud.nacos.config.namespace=31098de9-fa28-41c9-b0bd-c754ce319ed4 spring.cloud.nacos.config.ext-config[0].data-id=gulimall-datasource.yml spring.cloud.nacos.config.ext-config[0].refresh=false
spring.cloud.nacos.config.ext-config[0].group=dev
- 拆分
application.yml
,Nacos创建不同配置
application.yml
- 与数据源相关配置
- 与MyBatis相关配置
- 其他配置
- 拆分后效果
- 加载
通过一下语句配置组,每个选项有id、group、是否动态刷新三个配置选项
spring.cloud.nacos.config.ext-config[0].data-id=datasource.yml
spring.cloud.nacos.config.ext-config[0].group=dev
spring.cloud.nacos.config.ext-config[0].refresh=true
- 注释掉application.yml后仍可正常使用
启动时会加载三个配置
- 总结
- 微服务任何配置信息,任何配置文件都可以放在配置中心中
- 只需要在
bootstrap.properties
说明加载配置中心中哪些配置文件即可。 @Value
、@ConfigurationProperties
SpringBoot任何方式从配置文件中获取值,都可以使用
配置中心中有的优先使用配置中心的值
4. SpringCloud Alibaba-Sentinel
4.1 简介
官方文档:[https://github.com/alibaba/Sentinel/wiki/%E4%BB%8B%E7%BB%8D ](https://github.com/alibaba/Sentinel/wiki/%E4%BB%8B%E7%BB%8D)
项目地址:https://github.com/alibaba/Sentinel
随着微服务的流行,服务和服务之间的稳定性变得越来越重要。Sentinel 以流量为切入点, 从流量控制、熔断降级、系统负载保护等多个维度保护服务的稳定性。
Sentinel 具有以下特征:
- 丰富的应用场景:Sentinel 承接了阿里巴巴近 10 年的双十一大促流量的核心场景,例如秒杀(即突发流量控制在系统容量可以承受的范围)、消息削峰填谷、集群流量控制、实时熔断下游不可用应用等。
- 完备的实时监控:Sentinel 同时提供实时的监控功能。您可以在控制台中看到接入应用的单台机器秒级数据,甚至 500 台以下规模的集群的汇总运行情况。
- 广泛的开源生态:Sentinel 提供开箱即用的与其它开源框架/库的整合模块,例如与 Spring Cloud、Dubbo、gRPC 的整合。您只需要引入相应的依赖并进行简单的配置即可快速地接入 Sentinel。
- 完善的 SPI 扩展点:Sentinel 提供简单易用、完善的 SPI 扩展接口。您可以通过实现扩展接口来快速地定制逻辑。例如定制规则管理、适配动态数据源等。
Sentinel 分为两个部分:
- 核心库(Java 客户端)不依赖任何框架/库,能够运行于所有 Java 运行时环境,同时对 Dubbo / Spring Cloud 等框架也有较好的支持。
- 控制台(Dashboard)基于 Spring Boot 开发,打包后可以直接运行,不需要额外的Tomcat 等应用容器。
Sentinel 基本概念:
- 资源
资源是 Sentinel 的关键概念。它可以是 Java 应用程序中的任何内容,例如,由应用程序提供的服务,或由应用程序调用的其它应用提供的服务,甚至可以是一段代码。在接下来的文档中,我们都会用资源来描述代码块
只要通过Sentinel API定义的代码,就是资源,能够被Sentine保护起来。大部分情况下, 可以使用方法签名,URL,甚至服务名称作为资源名来标示资源。
- 规则
围绕资源的实时状态设定的规则,可以包括流量控制规则、熔断降级规则以及系统保护规则。所有规则可以动态实时调整。
4.2 Hystrix 与 Sentinel 比较
| 功能 | Sentinel | Hystrix |
| — | — | — |
| 隔离策略 | 信号量隔离(并发线程数限流) | 线程池隔离/信号量隔离 |
| 熔断降级策略 | 基于响应时间、异常比率、异常数 | 基于异常比率 |
| 实时统计实现 | 滑动窗口(LeapArray) | 滑动窗口(基于RxJava) |
| 动态规则设置 | 支持多种数据源 | 支持多种数据源 |
| 扩展性 | 多个扩展点 | 插件形式 |
| 基于注解的支持 | 支持 | 支持 |
| 限流 | 基于QPS,支持基于调用关系的限流 | 有限的支持 |
| 流量整形 | 支持预热模式、匀速器模式、预热排队模式 | 不支持 |
| 系统自适应保护 | 支持 | 不支持 |
| 控制台 | 可配置规则、查看秒级监控、机器发现等 | 简单的监控查看 |
4.3 整合 Feign+Sentinel 测试熔断降级
[https://github.com/alibaba/Sentinel/wiki/%E4%B8%BB%E9%A1%B5](https://github.com/alibaba/Sentinel/wiki/%E4%B8%BB%E9%A1%B5)
什么是熔断降级
除了流量控制以外,降低调用链路中的不稳定资源也是 Sentinel 的使命之一。由于调用关系的复杂性,如果调用链路中的某个资源出现了不稳定,最终会导致请求发生堆积。
Sentinel 和 Hystrix 的原则是一致的: 当检测到调用链路中某个资源出现不稳定的表现,例如请求响应时间长或异常比例升高的时候,则对这个资源的调用进行限制,让请求快速失败,避免影响到其它的资源而导致级联故障。
熔断降级设计理念
在限制的手段上,Sentinel 和 Hystrix 采取了完全不一样的方法。
Hystrix 通过线程池隔离
的方式,来对依赖(在 Sentinel 的概念中对应 资源)进行了隔离。这样做的好处是资源和资源之间做到了最彻底的隔离。缺点是除了增加了线程切换的成本(过多的线程池导致线程数目过多),还需要预先给各个资源做线程池大小的分配。
Sentinel对这个问题采取了两种手段:
- 通过并发线程数进行限制
和资源池隔离的方法不同,Sentinel 通过限制资源并发线程的数量,来减少不稳定资源对其它资源的影响。这样不但没有线程切换的损耗,也不需要您预先分配线程池的大小。当某个资源出现不稳定的情况下,例如响应时间变长,对资源的直接影响就是会造成线程数的逐步堆积。当线程数在特定资源上堆积到一定的数量之后,对该资源的新请求就会被拒绝。堆积的线程完成任务后才开始继续接收请求。
- 通过响应时间对资源进行降级
除了对并发线程数进行控制以外,Sentinel 还可以通过响应时间来快速降级不稳定的资源。当依赖的资源出现响应时间过长后,所有对该资源的访问都会被直接拒绝,直到过了指定的时间窗口之后才重新恢复。
测试整合
[https://github.com/alibaba/spring-cloud-alibaba/blob/master/spring-cloud-alibaba-examples/se ntinel-example/sentinel-feign-example/readme-zh.md](https://github.com/alibaba/spring-cloud-alibaba/blob/master/spring-cloud-alibaba-examples/se ntinel-example/sentinel-feign-example/readme-zh.md)
- 引入依赖
org.springframework.cloud
spring-cloud-starter-openfeign
com.alibaba.cloud
spring-cloud-starter-alibaba-sentinel
- 使用Nacos注册中心
com.alibaba.cloud
spring-cloud-starter-alibaba-nacos-discovery
- 定义 fallback 实现,在服务消费者中,实现 feign 远程接口,接口的实现方法即为调用错误的容错方法
public class OrderFeignServiceFallBack implements OrderFeignService { @Override public Resp getOrderInfo(String orderSn) { return null; } }
- 定义 fallbackfactory 并放在容器中
@Component public class OrderFeignFallbackFactory implements FallbackFactory { @Override public OrderFeignServiceFallBack create(Throwable throwable) { return new OrderFeignServiceFallBack(throwable); } }
- 改造 fallback 类接受异常并实现容错方法
public class OrderFeignServiceFallBack implements OrderFeignService { private Throwable throwable; public OrderFeignServiceFallBack(Throwable throwable){ this.throwable = throwable; } @Override public Resp getOrderInfo(String orderSn) { return Resp.fail(new OrderVo()); } }
- 远程接口配置 feign 客户端容错
@FeignClient(value = “gulimall-oms”,fallbackFactory = OrderFeignFallbackFactory.class) public interface OrderFeignService { @GetMapping(“/oms/order/bysn/{orderSn}”) public Resp getOrderInfo(@PathVariable(“orderSn”) String orderSn); }
- 开启 sentinel 代理 feign 功能;在 application.properties 中配置
feign.sentinel.enabled=true
测试熔断效果。当远程服务出现问题,会自动调用回调方法返回默认数据,并且更快的容错方式
- 使用@SentinelResource,并定义 fallback
@SentinelResource(value = “order”,fallback = “e”)
Fallback 和原方法签名一致,但是最多多一个 Throwable 类型的变量接受异常。
https://github.com/alibaba/Sentinel/wiki/%E6%B3%A8%E8%A7%A3%E6%94%AF%E6%8C%81
需要给容器中配置注解切面
@Bean public SentinelResourceAspect sentinelResourceAspect() { return new SentinelResourceAspect(); }
在控制台添加降级策略
- 测试降级效果
当远程服务停止,前几个服务会尝试调用远程服务,满足降级策略条件以后则不会再尝试调用远程服务
4.4 整合 Sentinel 测试限流(流量控制)
什么是流量控制
流量控制在网络传输中是一个常用的概念,它用于调整网络包的发送数据。然而,从系统稳 定性角度考虑,在处理请求的速度上,也有非常多的讲究。任意时间到来的请求往往是随机 不可控的,而系统的处理能力是有限的。我们需要根据系统的处理能力对流量进行控制。Sentinel 作为一个调配器,可以根据需要把随机的请求调整成合适的形状,如下图所示:
流量控制设计理念
流量控制有以下几个角度:
- 资源的调用关系,例如资源的调用链路,资源和资源之间的关系;
- 运行指标,例如 QPS、线程池、系统负载等;
- 控制的效果,例如直接限流、冷启动、排队等。
Sentinel 的设计理念是让您自由选择控制的角度,并进行灵活组合,从而达到想要的效果。
- 引入 Sentinel starter
com.alibaba.cloud
spring-cloud-starter-alibaba-sentinel
- 接入限流埋点
- HTTP 埋点
Sentinel starter 默认为所有的 HTTP 服务提供了限流埋点,如果只想对 HTTP 服务进行限流,那么只需要引入依赖,无需修改代码。
- 自定义埋点
如果需要对某个特定的方法进行限流或降级,可以通过 @SentinelResource 注解来完成限流的埋点,示例代码如下:
@SentinelResource(“resource”) public String hello() { return “Hello”; }
- 当然也可以通过原始的 SphU.entry(xxx) 方法进行埋点, 可以参见 [Sentinel 文档]( )
- 配置限流规则
Sentinel 提供了两种配置限流规则的方式:代码配置 和 控制台配置。
- 通过代码来实现限流规则的配置。一个简单的限流规则配置示例代码如下,更多限流规 则配置详情请参考 [Sentinel 文档]( )。
List rules = new ArrayList(); FlowRule rule = new FlowRule(); rule.setResource(str); // set limit qps to 10 rule.setCount(10); rule.setGrade(RuleConstant.FLOW_GRADE_QPS); rule.setLimitApp(“default”); rules.add(rule); FlowRuleManager.loadRules(rules);
- 通过控制台进行限流规则配置
- 下载控制台
- 启动控制台
执行 Java 命令 java -jar sentinel-dashboard.jar 完成 Sentinel 控制台的启动。 控制台默认的监听端口为 8080
- 启动应用并配置
增加配置,在应用的 /src/main/resources/application.properties 中添加基本配置信息
spring.application.name=sentinel-example
server.port=18083
spring.cloud.sentinel.transport.dashboard=localhost:8080
- 控制台配置限流规则并验证
访问 http://localhost:8080 页面
如果您在控制台没有找到应用,请调用一下进行了 Sentinel 埋点的 URL 或方法,因为Sentinel 使用了 lazy load 策略。
任意发送请求,可以在簇点链路里面看到刚才的请求,可以对请求进行流控;
- 自定义流控响应
@Configuration public class SentineConfig{ public SentineConfig(){ WebCallbackManager.setUrlBlockHandle(new UrlBlockHandler(){ @Overide public void blocked(HttpServletRequest request,HttpServletResponse response,BlockException ex) throws IOException{ response.getWriter().write(“limited”); } }) } }
- 持久化流控规则
默认的流控规则是保存在项目的内存中,项目停止再启动,流控规则就是失效。我们可以持久化保存规则 ;
生产环境使用模式:
我们推荐通过控制台设置规则后将规则推送到统一的规则中心,客户端实现ReadableDataSource接口端监听规则中心实时获取变更
解决方案:
DataSource 扩展常见的实现方式有:
- 拉模式:客户端主动向某个规则管理中心定期轮询拉取规则,这个规则中心可以是RDBMS、文件,甚至是 VCS 等。这样做的方式是简单,缺点是无法及时获取变更;
- 推模式:则中心统一推送,客户端通过注册监听器的方式时刻监听变化,比如使用Nacos、Zookeeper 等配置中心。这种方式有更好的实时性和一致性保证。
推模式:使用Nacos配置规则
- 引入依赖
com.alibaba.csp
sentinel-datasource-nacos
1.6.3
- 编写配置类
@Configuration public class SentinelConfig { public SentinelConfig() { //1、加载流控策略 ReadableDataSource flowRuleDataSource = new NacosDataSource<>(“127.0.0.1:8848”, “demo”, “sentinel”, source -> JSON.parseObject(source, new TypeReference() { })); FlowRuleManager.register2Property(flowRuleDataSource.getProperty()); //2、加载降级策略 ReadableDataSource degradeRuleDataSource = new NacosDataSource<>(“127.0.0.1:8848”, “demo”, “sentinel”, source -> JSON.parseObject(source, newTypeReference < List < DegradeRule >> () { })); DegradeRuleManager.register2Property(degradeRuleDataSource.getProperty()); //3、加载系统规则 ReadableDataSource systemRuleDataSource = new NacosDataSource<>(“127.0.0.1:8848”, “demo”, “sentinel”, source -> JSON.parseObject(source, newTypeReference < List < SystemRule >> () { })); SystemRuleManager.register2Property(systemRuleDataSource.getProperty()); //4、加载权限策略 ReadableDataSource authorityRuleDataSource = new NacosDataSource<>(“127.0.0.1:8848”, “demo”, “sentinel”, source -> JSON.parseObject(source, new TypeReference() { })); AuthorityRuleManager.register2Property(authorityRuleDataSource.getProperty( )); } }
参照 https://github.com/alibaba/Sentinel/wiki/Dynamic-Rule-Configuration 查看更多控制规则
API 的方式,可以直接变为配置方式;在 application.properties 中配置
spring.cloud.sentinel.datasource.ds.nacos.server-addr=127.0.0. 1:8848
spring.cloud.sentinel.datasource.ds.nacos.data-id=sentinel
spring.cloud.sentinel.datasource.ds.nacos.group-id=demo
spring.cloud.sentinel.datasource.ds.nacos.rule-type=flow
spring.cloud.sentinel.datasource.ds1.nacos.server-addr=127.0.0.1:8848
spring.cloud.sentinel.datasource.ds1.nacos.data-id=sentinel
spring.cloud.sentinel.datasource.ds1.nacos.group-id=demo
spring.cloud.sentinel.datasource.ds1.nacos.rule-type=system
ds,ds1 是随便写的。
- 在 nacos 中创建 dataId,并使用json 格式
- 添加一条流控规则测试
[ { “resource”: “/ums/member/list”, “limitApp”: “default”, “grade”: 1, “count”: 5, “strategy”: 0, “controlBehavior”: 0, “clusterMode”: false } ]
配 置 含 义 说 明 : https://github.com/alibaba/Sentinel/wiki/%E6%B5%81%E9%87%8F%E6%8E%A7%E5%88%B6
- resource:资源名,即限流规则的作用对象
- count: 限流阈值
- grade: 限流阈值类型(QPS 或并发线程数)
- limitApp: 流控针对的调用来源,若为 default 则不区分调用来源
- strategy: 调用关系限流策略
- controlBehavior: 流量控制效果(直接拒绝、Warm Up、匀速排队)
- 系统规则,降级规则等均可添加
[ { “resource”: “/ums/member/list”, “limitApp”: “default”, “grade”: 1, “count”: 5, “strategy”: 0, “controlBehavior”: 0, “clusterMode”: false }, { “highestSystemLoad”: -1, “highestCpuUsage”: 0.99, “qps”: 2, “avgRt”: 10, “maxThread”: 10 } ]
- 最终效果
Sentinel 控制台改变流控规则,不能推送到 nacos 中,Nacos 中改变流控规则可以实时观察到变化
5. SpringCloud Alibaba-Seata
5.1 简介
6. SpringCloud Alibaba-OSS
6.1 简介
对象存储服务(Object Storage Service,OSS)是一种海量、安全、低成本、高可靠的云存储服务,适合存放任意类型的文件。容量和处理能力弹性扩展,多种存储类型供选择,全面优化存储成本。
6.2 使用步骤
- 开通阿里云对象存储服务
https://www.aliyun.com/product/oss
- 引入SpringCloud Alibaba-OSS
com.alibaba.cloud
spring-cloud-alicloud-oss
- 配置阿里云oss 相关的账号信息
spring:
cloud:
alicloud:
oss:
endpoint: oss-cn-shanghai.aliyuncs.com
access-key: xxxxxx
secret-key: xxxxxx
注意:必须申请 RAM 账号信息,并且分配 OSS 操作权限
- 测试使用OssClient 上传
@Autowired OSSClient ossClient; @Test public void contextLoads2()throws FileNotFoundException{ InputStream inputStream=new FileInputStream(“C:\Users\lfy\Pictures\bug.jpg”);ossClient.putObject(“gulimall”,“aaa/bug222.jpg”,inputStream);System.out.println(“ok”);