Maven 自動ビルド

自動ビルドは、あるプロジェクトのビルドが成功した後、その関連する依存プロジェクトのビルドが開始されるというシナリオを定義します。これにより、依存プロジェクトの安定性を保証できます。

たとえば、あるチームがプロジェクト bus-core-api を開発しており、他の2つのプロジェクト app-web-ui と app-desktop-ui がこのプロジェクトに依存しているとします。

app-web-ui プロジェクトは bus-core-api プロジェクトの 1.0 スナップショットを使用しています:

<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>app-web-ui</groupId> <artifactId>app-web-ui</artifactId> <version>1.0</version> <packaging>jar</packaging> <dependencies> <dependency> <groupId>bus-core-api</groupId> <artifactId>bus-core-api</artifactId> <version>1.0-SNAPSHOT</version> </dependency> </dependencies> </project>

app-desktop-ui プロジェクトは bus-core-api プロジェクトの 1.0 スナップショットを使用しています:

<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>app-desktop-ui</groupId> <artifactId>app-desktop-ui</artifactId> <version>1.0</version> <packaging>jar</packaging> <dependencies> <dependency> <groupId>bus-core-api</groupId> <artifactId>bus-core-api</artifactId> <version>1.0-SNAPSHOT</version> </dependency> </dependencies> </project>

bus-core-api プロジェクト:

<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> </project>

現在、app-web-ui と app-desktop-ui プロジェクトのチームは、bus-core-api プロジェクトがいつ変更されても、そのビルドプロセスを開始できるようにすることを要求しています。

スナップショットを使用することで最新の bus-core-api プロジェクトが使用されることを保証できますが、上記の要件を満たすには、追加の作業が必要です。

2つの方法を使用できます:

  • bus-core-api プロジェクトの pom ファイルに post-build ゴール操作を追加して、app-web-ui と app-desktop-ui プロジェクトのビルドを開始します。
  • Hudson などの継続的インテグレーション(CI)サーバーを使用して、ビルド自動化を管理します。

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> <build> <plugins> <plugin> <artifactId>maven-invoker-plugin</artifactId> <version>1.6</version> <configuration> <debug>true</debug> <pomIncludes> <pomInclude>app-web-ui/pom.xml</pomInclude> <pomInclude>app-desktop-ui/pom.xml</pomInclude> </pomIncludes> </configuration> <executions> <execution> <id>build</id> <goals> <goal>run</goal> </goals> </execution> </executions> </plugin> </plugins> </build> </project>

コマンドコンソールを開き、C:\ > MVN > bus-core-api ディレクトリに移動して、以下のコマンドを実行します。

C:\MVN\bus-core-api>mvn clean package -U

コマンドの実行後、Maven はプロジェクト bus-core-api のビルドを開始します。

[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------
[INFO] Building bus-core-api
[INFO]    task-segment: [clean, package]
[INFO] ------------------------------------------------------------------
...
[INFO] [jar:jar {execution: default-jar}]
[INFO] Building jar: C:\MVN\bus-core-ui\target\
bus-core-ui-1.0-SNAPSHOT.jar
[INFO] ------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------

bus-core-api のビルドが成功すると、Maven は app-web-ui プロジェクトのビルドを開始します。

[INFO] ------------------------------------------------------------------
[INFO] Building app-web-ui 
[INFO]    task-segment: [package]
[INFO] ------------------------------------------------------------------
...
[INFO] [jar:jar {execution: default-jar}]
[INFO] Building jar: C:\MVN\app-web-ui\target\
app-web-ui-1.0-SNAPSHOT.jar
[INFO] ------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------

app-web-ui のビルドが成功すると、Maven は app-desktop-ui プロジェクトのビルドを開始します。

[INFO] ------------------------------------------------------------------
[INFO] Building app-desktop-ui 
[INFO]    task-segment: [package]
[INFO] ------------------------------------------------------------------
...
[INFO] [jar:jar {execution: default-jar}]
[INFO] Building jar: C:\MVN\app-desktop-ui\target\
app-desktop-ui-1.0-SNAPSHOT.jar
[INFO] -------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] -------------------------------------------------------------------

継続的インテグレーションサーバー(CI)を使用

もし CI サーバーを使用する場合、私たちは毎回新しいプロジェクト(たとえば例の app-mobile-ui)を bus-core-api プロジェクトへの依存として追加する際、開発者は bus-core-api プロジェクトの pom を更新する必要はありません。Hudson は Maven の依存関係管理機能を利用して、プロジェクトの自動ビルドを実現します。

Hudson は各プロジェクトのビルドを1つのタスクとみなします。プロジェクトのコードが SVN(または Hudson にマッピングされた任意のコード管理ツール)にコミットされると、Hudson はプロジェクトのビルドタスクを開始し、このビルドタスクが完了すると、Hudson は自動的に他の依存ビルドタスク(他の依存プロジェクトのビルド)を開始します。

上記の例では、bus-core-ui のソースコードが SVN で更新されると、Hudson はプロジェクトのビルドを開始します。ビルドが成功すると、Hudson は自動的に依存プロジェクトを検索し、app-web-ui と app-desktop-ui プロジェクトのビルドを開始します。

その他の拡張