對(duì)于Spring   Boot中的 Actuator 模塊相信大家早已經(jīng)不陌生了，尤其是對(duì)于其中的/health、/metrics等強(qiáng)大端點(diǎn)已經(jīng)不陌生。但是，其中還有一個(gè)比較特殊的端點(diǎn)/info經(jīng)常被大家所忽視，因?yàn)閺淖畛醯睦斫?，它主要用?lái)輸出application.properties配置文件中通過(guò)info前綴來(lái)定義的一些屬性，由于乍看之下可能想不到太多應(yīng)用場(chǎng)景，只是被用來(lái)暴露一些應(yīng)用的基本信息，而基本信息本身也可以在與Spring Cloud結(jié)合時(shí)作為服務(wù)治理的注冊(cè)信息統(tǒng)一管理，所以這個(gè)端點(diǎn)的用處并不是很大。

然而實(shí)際上，該端點(diǎn)除了描述應(yīng)用信息之外，也還可以用來(lái)描述Git版本信息，并且整合方法非常簡(jiǎn)單，下面我們就來(lái)看看如何使用/info端點(diǎn)暴露當(dāng)前應(yīng)用的Git版本信息。

POM配置

首先，我們可以挑選任意一個(gè)Spring Boot項(xiàng)目，修改它的pom.xml。引入spring-boot-starter-actuator，提供/info端點(diǎn)：

<dependency> 
    <groupId>org.springframework.boot</groupId> 
    <artifactId>spring-boot-starter-actuator</artifactId> 
</dependency> 

添加git-commit-id-plugin插件，該插件用來(lái)產(chǎn)生git的版本信息：

<plugin> 
    <groupId>pl.project13.maven</groupId> 
    <artifactId>git-commit-id-plugin</artifactId> 
    <version>2.1.15</version> 
    <executions> 
        <execution> 
            <goals> 
                <goal>revision</goal> 
            </goals> 
        </execution> 
    </executions> 
    <configuration> 
        <dotGitDirectory>${project.basedir}/.git</dotGitDirectory> 
    </configuration> 
</plugin> 

產(chǎn)生git版本信息

在完成了上面的配置之后，執(zhí)行g(shù)it-commit-id-plugin插件。

運(yùn)行完成后，我們可以在控臺(tái)中看到類(lèi)似下面的信息：

[INFO] pl.project13.maven.git.log.MavenLoggerBridge - dotGitDirectory E:\git_project\oschina\SpringBoot-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 
... 

同時(shí)，在target/classes目錄下，我們可以發(fā)現(xiàn)產(chǎn)生了一個(gè)git.properties配置信息。

這個(gè)文件就是當(dāng)前項(xiàng)目的git信息，它的內(nèi)容如下：

#Generated by Git-Commit-Id-Plugin 
#Thu Jun 01 17:57:53 CST 2017 
git.build.user.email=dyc87112@qq.com 
git.build.host=Lenovo-zhaiyc 
git.dirty=true 
git.remote.origin.url=https\://git.oschina.net/didispace/SpringBoot-Learning.git 
git.closest.tag.name=chapter1 
git.commit.id.describe-short=e0540b3-dirty 
git.commit.user.email=dyc87112@qq.com 
git.commit.time=2017-06-01T17\:57\:10+0800 
git.commit.message.full=update 
git.build.version=1.0.0 
git.commit.message.short=update 
git.commit.id.abbrev=e0540b3 
git.branch=master 
git.build.user.name=didi 
git.closest.tag.commit.count=240 
git.commit.id.describe=e0540b3-dirty 
git.commit.id=e0540b3524378de9b5d938668a0f75ec016fa5e5 
gitgit.tags= 
git.build.time=2017-06-01T17\:57\:53+0800 
git.commit.user.name=didi 

啟動(dòng)測(cè)試

完成了上述配置之后，啟動(dòng)應(yīng)用并訪問(wèn)端點(diǎn)，比如：curl localhost:8080/info，我們可以獲得如下輸出：

{ 
    "git": { 
        "commit": { 
            "time": 1496311030000, 
            "id": "e0540b3" 
        }, 
        "branch": "master" 
    } 
} 

其中包含了關(guān)于branch和commit的基礎(chǔ)信息。而這個(gè)信息格式是最簡(jiǎn)模式，我們也可以通過(guò)配置下面的參數(shù)來(lái)獲取更全面的git信息：

management.info.git.mode=full 

重啟應(yīng)用后再訪問(wèn)/info端點(diǎn)，可以獲得類(lèi)似下面更為詳細(xì)的版本信息了。

{ 
  "git": { 
    "build": { 
      "host": "Lenovo-zhaiyc", 
      "version": "1.0.0", 
      "time": 1496311073000, 
      "user": { 
        "name": "didi", 
        "email": "dyc87112@qq.com" 
      } 
    }, 
    "branch": "master", 
    "commit": { 
      "message": { 
        "short": "update", 
        "full": "update" 
      }, 
      "id": "e0540b3524378de9b5d938668a0f75ec016fa5e5", 
      "id.describe-short": "e0540b3-dirty", 
      "id.abbrev": "e0540b3", 
      "id.describe": "e0540b3-dirty", 
      "time": 1496311030000, 
      "user": { 
        "email": "dyc87112@qq.com", 
        "name": "didi" 
      } 
    }, 
    "closest": { 
      "tag": { 
        "name": "chapter1", 
        "commit": { 
          "count": "240" 
        } 
      } 
    }, 
    "dirty": "true", 
    "remote": { 
      "origin": { 
        "url": "https://git.oschina.net/didispace/SpringBoot-Learning.git" 
      } 
    }, 
    "tags": "" 
  } 
} 

【本文為51CTO專(zhuān)欄作者“翟永超”的原創(chuàng)稿件，轉(zhuǎn)載請(qǐng)通過(guò)51CTO聯(lián)系作者獲取授權(quán)】

戳這里，看該作者更多好文