Fork me on GitHub

Spring Cloud Alibaba升级到2.1.0

目录

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

Spring Cloud Alibaba News

从功能上讲,Spring Cloud Alibaba 2.1.0和0.9.0区别并不大,所以升级还是比较轻松的。下面列出升级的具体步骤:

一、升级依赖管理器

1
2
3
4
5
6
7
<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>

修改为:

1
2
3
4
5
6
7
<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

例如:将:

1
2
3
4
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

修改为:

1
2
3
4
<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了。

相关文章

评论系统未开启,无法评论!