4.2.4.2. コマンドラインで使用するための Maven の設定
アプリケーションをビルドし、JBoss EAP 6 にデプロイするのに必要なアーティファクトと依存関係はパブリックリポジトリーでホストされます。Red Hat JBoss Developer Studio を使用してアプリケーションをビルドおよびデプロイする場合は、このトピックをスキップできます。代わりに、次の手順に従ってください。「Red Hat JBoss Developer Studio で使用するための Maven の設定」。ただし、Maven コマンドラインを使用する場合は、Maven 設定を使用してプロジェクト全体で JBoss EAP 6 Maven リポジトリーを使用するように Maven に指示する必要があります。
Maven コマンドラインで使用するための設定方法は 2 つあります。
このトピックでは、両方の方法について説明します。クイックスタートがダウンロードされている場合、最初の手順が最も簡単な設定方法です。
- クイックスタートに付属している事前設定済みの
settings.xmlファイルをコピーできます。 - Maven の
settings.xmlファイルを手動で編集できます。
前提条件
設定する前に、Maven をインストールする必要があります。詳細は、 「Maven のダウンロードおよびインストール」 を参照してください。
手順4.4 クイックスタートの例に含まれる設定を使って Maven を設定する
Red Hat JBoss Enterprise Application Platform クイックスタートには、オンラインの JBoss EAP Maven リポジトリーを使用するように設定された
settings.xml ファイルが付属しています。クイックスタートがダウンロードされている場合、この方法が最も簡単な設定方法です。
- この手順では、既存の Maven 設定ファイルが上書きされるため、既存の
Mavensettings.xmlファイルをバックアップする必要があります。- オペレーティングシステムの Maven インストールディレクトリーを見つけます。通常、
USER_HOME/.m2/ディレクトリーにインストールされます。- Linux または Mac では、これは
~/.m2/になります。 - Windows の場合、これは次のとおりです。
\Documents and Settings\USER_NAME\.m2\または\Users\USER_NAME\.m2\
- 既存の
USER_HOME/.m2/settings.xmlファイルがある場合は、後で復元できるように、ファイルの名前を変更するか、バックアップコピーを作成します。
- クイックスタートをまだダウンロードしていない場合は、次の手順に従ってください。 「クイックスタートのダウンロード」。
QUICKSTART_HOME/settings.xmlファイルをUSER_HOME/.m2/ディレクトリーにコピーします。- Red Hat JBoss Developer Studio の実行中に
settings.xmlファイルを変更する場合は、このトピックの最後にある 『Refresh the Red Hat JBoss Developer Studio User Settings』 というタイトルトピックの最後にある手順に従ってください。
手順4.5 Online JBoss EAP Maven リポジトリーを使用するには、Maven 設定を手動で編集および設定します
JBoss EAP プロファイルを既存の Maven 設定ファイルに手動で追加できます。
- オペレーティングシステムの Maven インストールディレクトリーを見つけます。通常、
USER_HOME/.m2/ディレクトリーにインストールされます。- Linux または Mac では、これは
~/.m2/になります。 - Windows の場合、これは
\Documents and Settings\USER_NAME\.m2\または\Users\USER_NAME\.m2\です。
settings.xmlファイルが見つからない場合、settings.xmlファイルをUSER_HOME/.m2/conf/ディレクトリーからUSER_HOME/.m2/ディレクトリへコピーします。- 次の XML を
<profiles>ファイルの要素にコピーします。<!-- Configure the JBoss GA Maven repository --> <profile> <id>jboss-ga-repository</id> <repositories> <repository> <id>jboss-ga-repository</id> <url>http://maven.repository.redhat.com/techpreview/all</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>jboss-ga-plugin-repository</id> <url>http://maven.repository.redhat.com/techpreview/all</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> <!-- Configure the JBoss Early Access Maven repository --> <profile> <id>jboss-earlyaccess-repository</id> <repositories> <repository> <id>jboss-earlyaccess-repository</id> <url>http://maven.repository.redhat.com/earlyaccess/all/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>jboss-earlyaccess-plugin-repository</id> <url>http://maven.repository.redhat.com/earlyaccess/all/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile>次の XML をsettings.xmlファイルの要素<activeProfiles>にコピーします。<activeProfile>jboss-ga-repository</activeProfile> <activeProfile>jboss-earlyaccess-repository</activeProfile> - Red Hat JBoss Developer Studio の実行中に
settings.xmlファイルを変更する場合は、このトピックの最後にある 『Refresh the Red Hat JBoss Developer Studio User Settings』 というタイトルトピックの最後にある手順に従ってください。
手順4.6 Red Hat JBoss Developer Studio のユーザー設定を更新します
Red Hat JBoss Developer Studio の実行中に
settings.xml ファイルを変更する場合は、ユーザー設定を更新する必要があります。
- メニューから、
を選択します。 - Preferences ウインドウで Maven を展開表示し、User Settings を選択します。
- ボタンをクリックし、Red Hat JBoss Developer Studio で Maven のユーザー設定を更新します。
図4.11 Maven ユーザー設定を更新する
[D]
重要
Maven リポジトリーに古いアーティファクトが含まれる場合は、プロジェクトをビルドまたはデプロイしたときに以下のいずれかの Maven エラーメッセージが表示されることがあります。
この問題を解決するには、最新の Maven アーティファクトをダウンロードするためにローカルリポジトリーのキャッシュバージョンを削除します。キャッシュされたリポジトリーは、Linux の場合は
- アーティファクト ARTIFACT_NAME がありません
- [ERROR] Failed to execute goal on project PROJECT_NAME; Could not resolve dependencies for PROJECT_NAME
~/.m2/repository/ サブディレクトリー、Windows の場合は %SystemDrive%\Users\USERNAME\.m2\repository\ サブディレクトリーにあります。