11.4. 起動可能な JAR サーバーの Galleon レイヤーの指定
Galleon レイヤーを指定して、サーバーのカスタム設定をビルドできます。さらに、サーバーから除外する Galleon レイヤーを指定することもできます。
JBoss EAP XP 5.0 以降では、サーバーアーティファクトを取得するために、JBoss EAP 8.0 および JBoss EAP XP 5.0 チャネルを使用して JBoss EAP JAR Maven プラグインを設定する必要があります。JBoss EAP チャネルの詳細は、JBoss EAP インストールチャネルの管理 を参照してください。
最新の JBoss EAP XP 5.0 サーバーをプロビジョニングするための JBoss EAP および JBoss EAP XP チャネルを指定するには、次の例に従います。
<feature-pack-location> 要素を使用して、機能パックの場所を指定します。以下の例では、Maven プラグイン設定ファイルで <feature-pack-location> 要素内に org.jboss.eap.xp:wildfly-Galleon-pack を指定します。
<configuration>
<channels>
<channel>
<manifest>
<groupId>org.jboss.eap.channels</groupId>
<artifactId>eap-8.0</artifactId>
</manifest>
</channel>
<channel>
<manifest>
<groupId>org.jboss.eap.channels</groupId>
<artifactId>eap-xp-5.0</artifactId>
</manifest>
</channel>
</channels>
<feature-pack-location>org.jboss.eap.xp:wildfly-galleon-pack</feature-pack-location>
</configuration>
複数の機能パックを参照する必要がある場合は、それらを <feature-packs> 要素に一覧表示します。次の例では、JBoss EAP データソース機能パックを <feature-packs> 要素に追加しています。
<configuration>
<feature-packs>
<feature-pack>
<location>org.jboss.eap.xp:wildfly-galleon-pack</location>
</feature-pack>
<feature-pack>
<location>org.jboss.eap:eap-datasources-galleon-pack</location>
</feature-pack>
</feature-packs>
</configuration>
複数の機能パックから Galleon レイヤーを組み合わせて、起動可能な JAR サーバーを設定し、必要な機能を提供する対応の Galleon レイヤーのみを含めることができます。
ベアメタルプラットフォームで、設定ファイルで Galleon レイヤーを指定しない場合、プロビジョニングしたサーバーにはデフォルトの standalone-microprofile.xml 設定と同じ設定が含まれます。
OpenShift プラットフォームでは、プラグイン設定に <cloud/> 設定要素を追加した後に、設定ファイルで Galleon レイヤーを指定しない場合、プロビジョニングされたサーバーにはクラウド環境用に調整され、デフォルトの standalone-microprofile-ha.xml と似ている設定が含まれます。
前提条件
- Maven がインストールされている。
-
9.minor.micro.Final-redhat-XXXXXなどの最新の Maven プラグインを確認した。この場合の 9 はメジャーバージョン、minor はマイナーバージョン、micro はマイクロバージョン、X は Red Hat ビルド番号です。たとえば9.0.1.Final-redhat-00009です。
この手順の例では、以下のプロパティーを指定します。
-
Maven プラグインバージョンの場合は、
${bootable.jar.maven.plugin.version}です。
これらのプロパティーをプロジェクトで設定する必要があります。以下に例を示します。
<properties>
<bootable.jar.maven.plugin.version>9.0.1.Final-redhat-00009</bootable.jar.maven.plugin.version>
</properties>
手順
- アプリケーションの実行に必要な機能を提供する、サポートされる JBoss EAP Galleon レイヤーを特定します。
Maven プロジェクトの
pom.xmlファイルの<plugin>要素で JBoss EAP feature-pack の場所を参照します。以下の例は、jaxrs-serverベースレイヤーおよびjpa-distributedレイヤーを含む単一の feature-pack を組み込んでいます。jaxrs-serverベースレイヤーは、サーバーの追加サポートを提供します。<plugins> <plugin> <groupId>org.wildfly.plugins</groupId> <artifactId>wildfly-jar-maven-plugin</artifactId> <version>${bootable.jar.maven.plugin.version}</version> <configuration> <channels> <channel> <manifest> <groupId>org.jboss.eap.channels</groupId> <artifactId>eap-8.0</artifactId> </manifest> </channel> <channel> <manifest> <groupId>org.jboss.eap.channels</groupId> <artifactId>eap-xp-5.0</artifactId> </manifest> </channel> </channels> <feature-pack-location>org.jboss.eap.xp:wildfly-galleon-pack</feature-pack-location> <layers> <layer>jaxrs-server</layer> <layer>jpa-distributed</layer> </layers> <excluded-layers> <layer>jpa</layer> </excluded-layers> ... </configuration> </plugin> </plugins>この例では、プロジェクトからの
jpaレイヤーの除外も示しています。注記jpa-distributedレイヤーをプロジェクトに含める場合は、jaxrs-serverレイヤーからjpaレイヤーを除外する必要があります。jpaレイヤーはローカルの infinispan hibernate キャッシュを設定し、jpa-distributedレイヤーはリモート infinispan hibernate キャッシュを設定します。