2.3.2. Maven 設定を使用した JBoss EAP 6 Maven リポジトリーの設定
プロジェクトで JBoss EAP 6 の Maven リポジトリーを使用するよう Maven に指示する方法は 2 つあります。
このトピックでは、Maven 設定を使用して、すべてのプロジェクトで Maven によって JBoss EAP 6 Maven リポジトリーが使用されるようにする方法を説明します。これは推奨される方法です。
- Maven 設定を変更できます。これにより、Maven がすべてのプロジェクトで設定を使用するよう指示できます。
- プロジェクトの POM ファイルを設定できます。これは、設定を特定のプロジェクトに制限します。
オンラインまたはローカルにインストールされた JBoss EAP 6.2 リポジトリーを使用するよう、Maven を設定できます。オンラインのリポジトリーを使用する場合は、事前設定された設定ファイルを使用するか、JBoss EAP 6.2 Maven プロファイルを既存の設定ファイルに追加します。ローカルのリポジトリーを使用する場合は、リポジトリーをダウンロードし、ローカルにインストールされたリポジトリーを示すよう設定する必要があります。以下の手順は、JBoss EAP 6.2 向けに Maven を設定する方法です。
注記
リポジトリーの URL は、リポジトリーの場所 (ファイルシステムまたは Web サーバー) によって異なります。各インストールオプションの例は以下のとおりです。
- ファイルシステム
- file:///path/to/repo/jboss-eap-6.x-maven-repository
- Apache Web Server
- http://intranet.acme.com/jboss-eap-6.x-maven-repository/
- Nexus Repository Manager
- https://intranet.acme.com/nexus/content/repositories/jboss-eap-6.x-maven-repository
Maven を設定するには、Maven インストールグローバル設定またはユーザーインストール設定を使用します。ここでは、最も一般的な設定であるユーザーインストール設定を使用します。
手順2.6 クイックスタートサンプルの設定を使用した Maven の設定
Red Hat JBoss Enterprise Application Platform 6.2 のクイックスタートには、オンラインの JBoss EAP 6.2 Maven リポジトリーを使用するように設定されている
settings.xml ファイルが含まれています。これを使用するのが、最も簡単な設定方法です。
- この手順では、既存の Maven 設定ファイルが上書きされるため、既存の Maven
settings.xmlファイルをバックアップする必要があります。- Maven インストールディレクトリーの場所を確認します。通常、
USER_HOME/.m2/ディレクトリーにインストールされています。- オペレーティングシステムが Linux または Mac の場合は、
~/.m2/になります。 - Windows の場合は、
\Documents and Settings\USER_NAME\.m2\または\Users\USER_NAME\.m2\になります。
- 既存の
USER_HOME/.m2/settings.xmlファイルがある場合、名前を変更してバックアップコピーを作成し、後で復元できるようにします。
- JBoss EAP 6.2 に含まれるクイックスタートサンプルをダウンロードし、展開します。詳細は、本書の「クイックスタートコードサンプルのダウンロード」の項を参照してください。
QUICKSTART_HOME/settings.xmlファイルをUSER_HOME/.m2/ディレクトリーへコピーします。- JBoss Developer Studio の稼働中に
settings.xmlファイルを変更する場合は、以下の「JBoss Developer Studio ユーザー設定のリフレッシュ」の手順に従ってください。
手順2.7 オンラインの JBoss EAP 6.2 Maven リポジトリーを使用するよう手作業で Maven 設定を編集および設定する
手作業で JBoss EAP 6.2 プロファイルを既存の Maven 設定ファイルへ追加できます。
- Maven インストールディレクトリーの場所を確認します。通常、
USER_HOME/.m2/ディレクトリーにインストールされています。- オペレーティングシステムが Linux または Mac の場合は、
~/.m2/になります。 - Windows の場合は、
\Documents and Settings\USER_NAME\.m2\または\Users\USER_NAME\.m2\になります。
settings.xmlファイルが見つからない場合は、USER_HOME/.m2/conf/ディレクトリーのsettings.xmlファイルを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> - JBoss Developer Studio の稼働中に
settings.xmlファイルを変更する場合は、以下の「JBoss Developer Studio ユーザー設定のリフレッシュ」の手順に従ってください。
手順2.8 ローカルにインストールされた JBoss EAP リポジトリーを使用するよう設定する
ローカルのファイルシステムにインストールされた JBoss EAP 6.2 リポジトリーを使用するよう、設定を変更できます。
- Maven インストールディレクトリーの場所を確認します。通常、
USER_HOME/.m2/ディレクトリーにインストールされています。- オペレーティングシステムが Linux または Mac の場合は、
~/.m2/になります。 - Windows の場合は、
\Documents and Settings\USER_NAME\.m2\または\Users\USER_NAME\.m2\になります。
settings.xmlファイルが見つからない場合は、USER_HOME/.m2/conf/ディレクトリーのsettings.xmlファイルをUSER_HOME/.m2/ディレクトリーへコピーします。- 以下の XML を
settings.xmlファイルの<profiles>要素にコピーします。必ず、<url>を実際のリポジトリーの場所に変更してください。<profile> <id>jboss-eap-repository</id> <repositories> <repository> <id>jboss-eap-repository</id> <name>JBoss EAP Maven Repository</name> <url>file:///path/to/repo/jboss-eap-6.x-maven-repository</url> <layout>default</layout> <releases> <enabled>true</enabled> <updatePolicy>never</updatePolicy> </releases> <snapshots> <enabled>false</enabled> <updatePolicy>never</updatePolicy> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>jboss-eap-repository-group</id> <name>JBoss EAP Maven Repository</name> <url> file:///path/to/repo/jboss-eap-6.x-maven-repository </url> <layout>default</layout> <releases> <enabled>true</enabled> <updatePolicy>never</updatePolicy> </releases> <snapshots> <enabled>false</enabled> <updatePolicy>never</updatePolicy> </snapshots> </pluginRepository> </pluginRepositories> </profile>次の XML をsettings.xmlファイルの<activeProfiles>要素へコピーします。<activeProfile>jboss-eap-repository</activeProfile> - JBoss Developer Studio の稼働中に
settings.xmlファイルを変更する場合は、以下の「JBoss Developer Studio ユーザー設定のリフレッシュ」の手順に従ってください。
手順2.9 JBoss Developer Studio ユーザー設定のリフレッシュ
JBoss Developer Studio の稼働中に
settings.xml ファイルを変更する場合は、ユーザー設定をリフレッシュする必要があります。
- メニューより、
を選択します。 - Preferences ウインドウで Maven を展開し、User Settings を選択します。
- ボタンをクリックし、JBoss Developer Studio で Maven のユーザー設定をリフレッシュします。
図2.1 Maven ユーザー設定の更新
重要
Maven リポジトリーに古いアーティファクトが含まれる場合は、プロジェクトをビルドまたはデプロイしたときに以下のいずれかの Maven エラーメッセージが表示されることがあります。
この問題を解決するには、最新の Maven アーティファクトをダウンロードするためにローカルリポジトリーのキャッシュバージョンを削除します。キャッシュバージョンは
- Missing artifact ARTIFACT_NAME
- [ERROR] Failed to execute goal on project PROJECT_NAME; Could not resolve dependencies for PROJECT_NAME
~/.m2/repository/ サブディレクトリー (Linux の場合) または %SystemDrive%\Users\USERNAME\.m2\repository\ サブディレクトリー (Windows の場合) に存在します。