TIPS
本文基于Spring Cloud Greenwich SR3编写,理论支持Spring Cloud Greenwich所有版本。
对于非Greenwich版本,请前往 https://github.com/alibaba/spring-cloud-alibaba/wiki/版本说明 查看Spring Cloud与Spring Cloud Alibaba的版本兼容性关系,自行升级到对应的兼容版本。例如:你用的是Spring Cloud Finchley,那么应使用Spring Cloud Alibaba 2.0.0,以此类推。
最近,Spring Cloud Alibaba已经从Spring Cloud孵化器中孵化成功。孵化成功后的最新版本是2.1.0。这一节来详细探讨如何将Spring Cloud Alibaba从0.9.0升级到2.1.0。
从0.9.0开始,Maven的Group id发生了变化!
•0.9.0的Group id是 org.springframework.cloud•0.9.0以上的版本是 com.alibaba.cloud
这看起来还挺吓人的,而且此前也引发了一些吐槽。其实这主要是由于Spring Cloud考虑简化自己的Release Train(即:Spring Cloud自身的版本管理),于是修改了发布政策:非Spring Cloud团队维护的Spring Cloud的子项目,一律使用自己的GroupId即可,不再强制使用 org.springframework.cloud 。
TIPS
详见:https://spring.io/blog/2019/07/24/simplifying-the-spring-cloud-release-train[1]
从功能上讲,Spring Cloud Alibaba 2.1.0和0.9.0区别并不大,所以升级还是比较轻松的。下面列出升级的具体步骤:
一、升级依赖管理器
将
<dependency>
<groupid>org.springframework.cloud/<groupid>
<artifactid>spring-cloud-alibaba-dependencies/<artifactid> <version>0.9.0.RELEASE/<version> <type>pom/<type> <scope>import/<scope>/<dependency>
修改为:
<dependency>
<groupid>com.alibaba.cloud/<groupid>
<artifactid>spring-cloud-alibaba-dependencies/<artifactid>
<version>2.1.0.RELEASE/<version>
<type>pom/<type>
<scope>import/<scope>
/<dependency>
其实就是改个groupId以及version。
二、升级Starter
将Spring Cloud Alibaba所有相关的Starter依赖(即以 spring-cloud-starter-alibaba- 开头的所有依赖),的groupId,全部更换成com.alibaba.cloud 。
例如:将:
<dependency>
<groupid>org.springframework.cloud/<groupid>
<artifactid>spring-cloud-starter-alibaba-nacos-discovery/<artifactid>
/<dependency>
修改为:
<dependency>
<groupid>com.alibaba.cloud/<groupid>
<artifactid>spring-cloud-starter-alibaba-nacos-discovery/<artifactid>
/<dependency>
三、升级Server软件版本
由于Spring Cloud Alibaba使用了Nacos、Sentinel Dashboard、RocketMQ,所以还得升级这三款软件的Server端。
TIPS
普及一个技巧:可根据客户端版本,去下载相同版本/兼容版本的Server端。
举个例子:
•通过分析,可以发现 spring-cloud-starter-alibaba-nacos-discovery 使用了Nacos Client 1.1.1,所以下载Nacos Server 1.1x 肯定是兼容的。
当然,其实在官方文档 https://github.com/alibaba/spring-cloud-alibaba/wiki/版本说明
分别下载:
•Nacos Server 1.1.x
•Sentinel Dashboard 1.6.x
•RocketMQ 4.4.x(笔者经过测试,使用RocketMQ 4.5.1也是OK的)
四、修正编译报错
如果你使用了原Spring Cloud Alibaba的一些类,那么升级后,很可能会报错。这主要是因为,Spring Cloud Alibaba的包名结构也发生了变化。原先的包结构是 org.springframework.cloud.xxx ,升级后包名也改成了com.alibaba.cloud.xxx 。
重新导一下包一下就OK了。
閱讀更多 IT牧場 的文章