来一个简单的,微服务项目中如何管理依赖版本号?

开发 项目管理
理论上,在微服务架构中,各个独立的微服务可以是各种语言,像我们使用的 Eureka 注册中心,就是支持多种语言的,这样可以充分发挥各种语言的优势。如果是这样,就没有必要从项目整体上进行版本管理了,也管不了。

[[328726]]

1.微服务架构

理论上的微服务架构和实际应用的微服务,往往会有一些差异。

理论上,在微服务架构中,各个独立的微服务可以是各种语言,像我们使用的 Eureka 注册中心,就是支持多种语言的,这样可以充分发挥各种语言的优势。如果是这样,就没有必要从项目整体上进行版本管理了,也管不了。

但是在实际操作中,考虑到团队的技术栈,现有的技术生态等因素,大部分情况下,我们可能并不会在项目中掺杂其他语言进来,比如就是用 Java 开发,相信大部分小伙伴都是这么做的。

既然统一都使用 Java 语言开发,那一个需求就随之浮出水面,就是项目依赖统一管理。

这个问题其实不是绝对的。

大型的微服务项目分属不同的团队开发,每个团队维护好自己的项目,然后通过 RPC 或者 HTTP 的方式互相之间进行交互,这种情况下,版本号也可以交由各个团队自行维护,这样版本升级的时候,就不必一起升级,可以各个团队独自完成,逐个升级。

但是这种方式又可能会带来另外一个问题,就是依赖版本的碎片化,在经过 N 多次迭代之后,可能会存在两个项目所依赖的微服务版本差异非常大。

因此,在实际操作中,有的团队会倾向于将项目版本统一管理。

统一管理也很简单,就是搞一个 parent 就行了,但是有的小伙伴容易将这种 parent 和聚合工程搞混,因此松哥这里还是和大家稍微聊一下怎么统一管理项目版本号。

2.统一管理版本号

2.1 聚合工程

先来说一说聚合工程,这里我就不重新写代码了,以微人事(https://github.com/lenve/vhr)为例来和大家分享。

微人事项目的服务端就是一个聚合工程。

我们可以来看下 vhrserver 的 pom.xml 文件:

 

  1. <parent> 
  2.     <artifactId>vhr</artifactId> 
  3.     <groupId>org.javaboy</groupId> 
  4.     <version>1.0-SNAPSHOT</version> 
  5. </parent> 
  6. <modelVersion>4.0.0</modelVersion> 
  7. <artifactId>vhrserver</artifactId> 
  8. <packaging>pom</packaging> 
  9. <modules> 
  10.     <module>vhr-mapper</module> 
  11.     <module>vhr-model</module> 
  12.     <module>vhr-service</module> 
  13.     <module>vhr-web</module> 
  14. </modules> 

在这个聚合工程中,vhr-model 用来放实体类,vhr-mapper 用来放 Dao 层,vhr-server 用来放 Service 层,vhr-web 则是一个 Spring Boot 工程。

在聚合工程中,vhr-web 作为聚合工程的一部分,是无法独立打包的,因为它依赖 vhr-service,vhr-service 依赖 vhr-mapper ,而 vhr-mapper 则依赖 vhr-model。我们需要从 vhrserver 处打包,这样它会自动解决 module 之间的依赖问题。

单独给 vhr-web 打包会报如下错误:

从 vhrserver 处统一打包,结果如下:

可以看到,我们需要直接打包聚合工程,内部的依赖问题会自动解决。

有人可能会问,既然前面报 Could not find artifact org.javaboy:vhr-service:pom:1.0-SNAPSHOT 错误,那我先把 vhr-service install 到本地仓库,再去打包 vhr-web 行不行?

这个是不行的,因为这是聚合工程,不能这样做,只能从聚合工程处打包。

2.2 统一管理版本号

上面说的聚合工程虽然也能实现版本号的统一管理,但是我们不能在微服务中采用这种方式。

你想一个微服务系统,包含了很多子系统,例如商品管理、交易管理、物流管理等等,要是想给商品管理打包,你还得从聚合工程处打包,打完之后,其他微服务模块也生成了各自的包,这样效率太低了。

但是我们还想实现版本号的统一管理,该怎么办呢?创建父子工程即可。这种项目结构和聚合工程很像,但是不一样,很多小伙伴会搞混,所以这里我来给大家稍微演示一下。

首先我们定义一个普通的 Maven 工程作为父工程,我把 pom.xml 文件拎出来给大家参考下:

  1. <parent> 
  2.     <groupId>org.springframework.boot</groupId> 
  3.     <artifactId>spring-boot-starter-parent</artifactId> 
  4.     <version>2.3.0.RELEASE</version> 
  5.     <relativePath/> 
  6. </parent> 
  7. <packaging>pom</packaging> 
  8. <groupId>org.javaboy.vmall</groupId> 
  9. <artifactId>vmall</artifactId> 
  10. <version>1.0-SNAPSHOT</version> 
  11. <properties> 
  12.     <!--省略--> 
  13. </properties> 
  14. <dependencyManagement> 
  15.     <dependencies> 
  16.         <!--省略--> 
  17.     </dependencies> 
  18. </dependencyManagement> 

大家可以看到,这个父工程本身也有一个 parent ,就是 Spring Boot 中的 parent。

这里的 packaging 依然是 pom,然后我们定义了 dependencyManagement,将一些不包含在 spring-boot-starter-parent 中的依赖版本进行统一管理。但是大家注意,这里没有 modules 节点,这是一个很大的不同。

接下来,我们创建其他微服务项目,在创建的过程中,可以采用平铺的方式,例如下面这样:

也可以做成有层次结构的父子形式,像下面这样:

两种方式都可以。

然后在各个微服务项目中,重新修改 parent 即可:

如此之后,我们就可以对各个微服务中的依赖版本进行统一管理了。

这种项目结构和聚合工程并不一样,这种项目打包,是可以独立打包的。

首先我们先将父工程 install 到本地仓库:

然后再去 install vmall-common 模块,最后给 vmall-app-manager 进行打包,注意,现在的 vmall-app-manager 可以独立打包,不需要从总的 parent 处进行统一打包。微服务项目中如果需要对项目版本进行统一管理,可以采用这种方式。

小伙伴们可以仔细品一品这种方式和聚合工程的差异。

3.小结

好啦,今天的内容比较简单,再结合前面已经发过的两篇文章,相信大家对于如何组织微服务项目的代码已经有一定的思路了。

本文授权转载自公众号「牧码小子」。公众号牧码小子分享大量Java 微服务干货,欢迎关注!

 

责任编辑:武晓燕 来源: 江南一点雨
相关推荐

2023-01-09 17:46:07

项目版本号字段

2024-07-08 13:56:12

微服务API代码

2011-08-18 09:56:57

MozillaFirefox

2014-12-15 14:02:48

iOS版本号苹果

2017-03-30 16:56:43

Windows 10Windows版本号

2018-05-30 10:04:38

容器技术微服务

2021-10-17 23:46:06

Go项目版本号

2017-02-08 14:29:04

2010-06-28 10:13:17

SQL Server

2019-09-19 15:15:20

LinuxMint版本号

2021-05-20 13:22:31

架构运维技术

2010-07-09 13:01:50

SQL Server

2010-11-08 10:07:45

Chrome

2019-08-06 13:37:55

微服务架构数据

2019-11-04 14:20:47

APP版本移动端命名

2022-11-08 08:35:53

架构微服务移动

2023-01-03 08:26:56

2017-02-22 09:30:41

2009-10-26 08:44:48

Windows 7查看版本号

2021-03-02 09:45:07

java循环依赖开发技术
点赞
收藏

51CTO技术栈公众号