Maven 自動化部署

專案開發過程中，部署的過程包含需如下步驟：

  • 將所的專案代碼提交到 SVN 或者代碼庫中並打上標籤。
  • 從 SVN 上下載完整的源代碼。
  • 構建應用。
  • 存儲構建輸出的 WAR 或者 EAR 檔到一個常用的網路位置下。
  • 從網路上獲取檔並且部署檔到生產站點上。
  • 更新文檔並且更新應用的版本號。

問題描述

通常情況下上面的提到開發過程中會涉及到多個團隊。一個團隊可能負責提交代碼，另一個團隊負責構建等等。很有可能由於涉及的人為操作和多團隊環境的原因，任何一個步驟都可能出錯。比如，較舊的版本沒有在網路機器上更新，然後部署團隊又重新部署了較早的構建版本。

解決方案

通過結合以下方案來實現自動化部署：

  • 使用 Maven 構建和發佈專案
  • 使用 SubVersion， 源碼倉庫來管理源代碼
  • 使用遠程倉庫管理軟體（Jfrog或者Nexus） 來管理專案二進位檔。

修改專案的 pom.xml

我們將會使用 Maven 發佈的插件來創建一個自動化發佈過程。

例如，bus-core-api 專案的 pom.xml 檔代碼如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>bus-core-api</groupId> <artifactId>bus-core-api</artifactId> <version>1.0-SNAPSHOT</version> <packaging>jar</packaging> <scm> <url>http://www.svn.com</url> <connection>scm:svn:http://localhost:8080/svn/jrepo/trunk/ Framework</connection> <developerConnection>scm:svn:${username}/${password}@localhost:8080: common_core_api:1101:code</developerConnection> </scm> <distributionManagement> <repository> <id>Core-API-Java-Release</id> <name>Release repository</name> <url>http://localhost:8081/nexus/content/repositories/ Core-Api-Release</url> </repository> </distributionManagement> <build> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-release-plugin</artifactId> <version>2.0-beta-9</version> <configuration> <useReleaseProfile>false</useReleaseProfile> <goals>deploy</goals> <scmCommentPrefix>[bus-core-api-release-checkin]-< /scmCommentPrefix> </configuration> </plugin> </plugins> </build> </project>

在 pom.xml 檔中，我們常用到的一些重要元素節點如下表所示：

元素節點 描述
SCM 配置 SVN 的路徑，Maven 將從該路徑下將代碼取下來。
repository 構建的 WAR 或 EAR 或JAR 檔的位置，或者其他源碼構建成功後生成的構件的存儲位置。
Plugin 配置 maven-release-plugin 插件來實現自動部署過程。

Maven Release 插件

Maven 使用 maven-release-plugin 插件來完成以下任務。

mvn release:clean

清理工作空間，保證最新的發佈進程成功進行。

mvn release:rollback

在上次發佈過程不成功的情況下，回滾修改的工作空間代碼和配置保證發佈過程成功進行。

mvn release:prepare

執行多種操作：

  • 檢查本地是否存在還未提交的修改
  • 確保沒有快照的依賴
  • 改變應用程式的版本資訊用以發佈
  • 更新 POM 檔到 SVN
  • 運行測試用例
  • 提交修改後的 POM 檔
  • 為代碼在 SVN 上做標記
  • 增加版本號和附加快照以備將來發佈
  • 提交修改後的 POM 檔到 SVN
mvn release:perform

將代碼切換到之前做標記的地方，運行 Maven 部署目標來部署 WAR 檔或者構建相應的結構到倉庫裏。

打開命令終端，進入到 C:\ > MVN >bus-core-api 目錄下，然後執行如下的 mvn 命令。

C:\MVN\bus-core-api>mvn release:prepare

Maven 開始構建整個工程。構建成功後即可運行如下 mvn 命令。

C:\MVN\bus-core-api>mvn release:perform

構建成功後，你就可以可以驗證在你倉庫下上傳的 JAR 檔是否生效。