關(guān)于release與snapshot的區(qū)別這里不再贅述祭钉,maven項目在生產(chǎn)環(huán)境部署的時候一定是需要打release包的匙姜。
maven-release-plugin 可用于構(gòu)建release版本項目靡馁,實現(xiàn)自動打tag攀圈、遞增版本號搓彻、分發(fā)release版本jar包至倉庫簇搅。
pom.xml配置:
<!--git 遠程倉庫配置-->
<scm>
<connection>scm:git:http://項目git地址</connection>
<url>項目git地址(不加'.git后綴')</url>
<developerConnection>scm:項目git地址</developerConnection>
</scm>
<!--構(gòu)建配置-->
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-release-plugin</artifactId>
<version>2.5.3</version>
<configuration>
<tagNameFormat>v@{project.version}</tagNameFormat>
<autoVersionSubmodules>true</autoVersionSubmodules>
</configuration>
</plugin>
</plugins>
</build>
<!--分發(fā)配置-->
<distributionManagement>
<repository>
<id>deploymentRepo</id>
<name>releases</name>
<url>http://somehost/repository/maven-releases/</url>
<uniqueVersion>true</uniqueVersion>
</repository>
<snapshotRepository>
<id>deploymentRepo</id>
<name>snapshots</name>
<url>http://somehost/repository/maven-snapshots/</url>
<uniqueVersion>true</uniqueVersion>
</snapshotRepository>
</distributionManagement>
由于會將構(gòu)建的包分發(fā)到倉庫完域,需要在maven的配置文件setting.xml下加入權(quán)限配置:
<server>
<id>your id</id>
<username>your username</username>
<password>your pass</password>
</server>
這里最關(guān)鍵的一點是scm節(jié)點配置,無論項目是使用git瘩将、svn或是其他版本控制工具吟税,都可以在這里配置,詳細的配置可參考scms-overview姿现。
下面是一個項目配置示例:
<scm>
<connection>scm:git:http://git-local.bnz.com/srv/bnz-ep.git</connection>
<url>http://git-local.bnz.com/srv/bnz-ep</url>
<developerConnection>scm:git:http://git-local.bnz.com/srv/bnz-ep.git</developerConnection>
</scm>
如果需要跳過單元測試肠仪,可以加入?yún)?shù) -Darguments="-DskipTests"
,直接使用-Dmaven.test.skip=true
是無效的建钥。
在執(zhí)行mvn release:perform
時默認會生成api文檔藤韵,如果默寫注釋不符合規(guī)范的話會造成構(gòu)建失敗,可以加參數(shù)-DuseReleaseProfile=false
取消構(gòu)建api文檔熊经,或則需要根據(jù)規(guī)范書寫注釋泽艘。
mvn release:prepare
mvn release:perform
如果在構(gòu)建過程中出現(xiàn)錯誤,rollback回滾即可
mvn release:rollback