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 ファイルが有効かどうかを確認できます。

その他の拡張