2.3.2. Maven 設定を使用した JBoss EAP 6 Maven リポジトリーの設定
プロジェクトで JBoss EAP 6 Maven リポジトリーを使用するよう Maven に指示する方法は 2 つあります。
このトピックでは、Maven 設定を使用してすべてのプロジェクトで JBoss EAP 6 Maven リポジトリーを使用するように Maven に指示する方法を示します。これは、推奨の手法です。
- Maven の設定を変更できます。これにより、Maven はすべてのプロジェクトで設定を使用するように指示されます。
- プロジェクトの POM ファイルを設定できます。これにより、設定が特定のプロジェクトに制限されます。
オンラインまたはローカルにインストールされた JBoss EAP 6 リポジトリーを使用するように Maven を設定できます。オンラインリポジトリーを使用する場合は、事前設定された設定ファイルを使用するか、JBoss EAP 6 Maven プロファイルを既存の設定ファイルに追加できます。ローカルリポジトリーを使用するには、リポジトリーをダウンロードし、ローカルにインストールされたリポジトリーを指すように設定を設定する必要があります。以下の手順では、JBoss EAP 6 用に Maven を設定する方法について説明します。
注記
リポジトリーの URL はリポジトリーの場所 (ファイルシステムまたは Web サーバー) によって異なります。リポジトリーのインストール方法については、を参照してください。「JBoss EAP 6 Maven リポジトリーをインストールします」。各インストールオプションの例は次のとおりです。
- ファイルシステム
- file:///path/to/repo/jboss-eap-6.x-maven-repository
- Apache Web Server
- http://intranet.acme.com/jboss-eap-6.x-maven-repository/
- Nexus リポジトリーマネージャー
- https://intranet.acme.com/nexus/content/repositories/jboss-eap-6.x-maven-repository
Maven は、Maven インストールのグローバル設定またはユーザーインストール設定のいずれかを使用して設定できます。これらの手順は、これが最も一般的な設定であるため、ユーザーのインストール設定を設定します。
手順2.6 クイックスタートの例に含まれる設定を使って Maven を設定する
JBoss EAP 6 クイックスタートには、オンライン JBoss EAP 6 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
ファイルがある場合は、後で復元できるように、ファイルの名前を変更するか、バックアップコピーを作成します。
- JBoss EAP 6 に付属のクイックスタートの例をダウンロードして解凍します。詳細は、「クイックスタートにアクセスする」 を参照してください
QUICKSTART_HOME/settings.xml
ファイルをUSER_HOME/.m2/
ディレクトリーにコピーします。- Red Hat JBoss Developer Studio の実行中に
settings.xml
ファイルを変更する場合は、以下のタイトルの手順に従ってください。手順2.9「Red Hat JBoss Developer Studio のユーザー設定を更新します」。
手順2.7 Online JBoss EAP 6 Maven リポジトリーを使用するには、Maven 設定を手動で編集および設定します
JBoss EAP 6 プロファイルを既存の 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
ファイルを変更する場合は、以下のタイトルの手順に従ってください。手順2.9「Red Hat JBoss Developer Studio のユーザー設定を更新します」。
手順2.8 ローカルにインストールされた JBoss EAP リポジトリーを使用するように設定を設定します
ローカルファイルシステムにインストールされている JBoss EAP 6 リポジトリーを使用するように設定を変更できます。
- オペレーティングシステムの 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 を
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>
- Red Hat JBoss Developer Studio の実行中に
settings.xml
ファイルを変更する場合は、以下のタイトルの手順に従ってください。手順2.9「Red Hat JBoss Developer Studio のユーザー設定を更新します」。
手順2.9 Red Hat JBoss Developer Studio のユーザー設定を更新します
Red Hat JBoss Developer Studio の実行中に
settings.xml
ファイルを変更する場合は、ユーザー設定を更新する必要があります。
- メニューから、
を選択します。 - Preferences ウインドウで Maven を展開表示し、User Settings を選択します。
図2.1 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\
サブディレクトリーにあります。