对于Spring Boot的Actuator模块相信大家已经不陌生了,尤其对于其中的/health、/metrics等强大端点已经不陌生(如您还不了解Actuator模块,建议先阅读《Spring Boot Actuator监控端点小结》)。但是,其中还有一个比较特殊的端点/info经常被大家所忽视,因为从最初的理解,它主要用来输出application.properties配置文件中通过info前缀来定义的一些属性,由于乍看之下可能想不到太多应用场景,只是被用来暴露一些应用的基本信息,而基本信息本身也可以在与Spring Cloud结合时作为服务治理的注册信息统一管理,所以这个端点的用处并不是很大。
然而实际上,该端点除了描述应用信息之外,也还可以用来描述Git版本信息,并且整合方法非常简单,下面我们就来看看如何使用/info端点暴露当前应用的Git版本信息。
POM配置
首先,我们可以挑选任意一个Spring Boot项目,修改它的pom.xml:
- 引入spring-boot-starter-actuator,提供/info端点
![acde86e4b236b8e0c85d556e39f9ff11.png](https://img-blog.csdnimg.cn/img_convert/acde86e4b236b8e0c85d556e39f9ff11.png)
- 添加git-commit-id-plugin插件,该插件用来产生git的版本信息
![c60bb84b0324e1ff07e2d6d519e3888a.png](https://img-blog.csdnimg.cn/img_convert/c60bb84b0324e1ff07e2d6d519e3888a.png)
产生git版本信息
- 在完成了上面的配置之后,执行git-commit-id-plugin插件
![a00ab50b7f64b3ca83df5379633d9c9b.png](https://img-blog.csdnimg.cn/img_convert/a00ab50b7f64b3ca83df5379633d9c9b.png)
运行完成后,我们可以在控台中看到类似下面的信息:
[INFO] pl.project13.maven.git.log.MavenLoggerBridge - dotGitDirectory E:git_projectoschinaSpringBoot-Learning.git[INFO] pl.project13.maven.git.log.MavenLoggerBridge - git.build.user.name didi[INFO] pl.project13.maven.git.log.MavenLoggerBridge - git.build.user.email dyc87112@qq.com[INFO] pl.project13.maven.git.log.MavenLoggerBridge - git.branch master[INFO] pl.project13.maven.git.log.MavenLoggerBridge - --always = true[INFO] pl.project13.maven.git.log.MavenLoggerBridge - --dirty = -dirty[INFO] pl.project13.maven.git.log.MavenLoggerBridge - --abbrev = 7[INFO] pl.project13.maven.git.log.MavenLoggerBridge - Tag refs [ [Ref[refs/tags/chapter1=ec8713f61cd49569886708a08adea02c8ef0a112]] ][INFO] pl.project13.maven.git.log.MavenLoggerBridge - Created map: [ {} ] [INFO] pl.project13.maven.git.log.MavenLoggerBridge - HEAD is [ e0540b3524378de9b5d938668a0f75ec016fa5e5 ] [INFO] pl.project13.maven.git.log.MavenLoggerBridge - Repo is in dirty state [ true ][INFO] pl.project13.maven.git.log.MavenLoggerBridge - git.commit.id.describe e0540b3-dirty[INFO] pl.project13.maven.git.log.MavenLoggerBridge - git.commit.id e0540b3524378de9b5d938668a0f75ec016fa5e5[INFO] pl.project13.maven.git.log.MavenLoggerBridge - git.commit.id.abbrev e0540b3[INFO] pl.project13.maven.git.log.MavenLoggerBridge - git.dirty true...
同时,在target/classes目录下,我们可以发现产生了一个git.properties配置信息:
![6eb0cf28d198d49de79b8c717b3cc1aa.png](https://img-blog.csdnimg.cn/img_convert/6eb0cf28d198d49de79b8c717b3cc1aa.png)
这个文件就是当前项目的git信息,它的内容如下:
![8f71dbfe06af1aa336d2fc65e68cd52c.png](https://img-blog.csdnimg.cn/img_convert/8f71dbfe06af1aa336d2fc65e68cd52c.png)
启动测试
完成了上述配置之后,启动应用并访问端点,比如:curl localhost:8080/info,我们可以获得如下输出:
![2c05f7313ee9acac125d8cf0316f2c37.png](https://img-blog.csdnimg.cn/img_convert/2c05f7313ee9acac125d8cf0316f2c37.png)
其中包含了关于branch和commit的基础信息。而这个信息格式是最简模式,我们也可以通过配置下面的参数来获取更全面的git信息:
![ce8a2bc8ffdd68684468d86fc4bac3c7.png](https://img-blog.csdnimg.cn/img_convert/ce8a2bc8ffdd68684468d86fc4bac3c7.png)
重启应用后再访问/info端点,可以获得类似下面更为详细的版本信息了。
![fbfef0735da2f70f7353184197392d28.png](https://img-blog.csdnimg.cn/img_convert/fbfef0735da2f70f7353184197392d28.png)
![9103a60cda767adf68ada923455e5ae2.png](https://img-blog.csdnimg.cn/img_convert/9103a60cda767adf68ada923455e5ae2.png)