8.4. 起動可能な JAR サーバーの Galleon レイヤーの指定
Galleon レイヤーを指定して、サーバーのカスタム設定をビルドできます。さらに、サーバーから除外する Galleon レイヤーを指定することもできます。
単一の機能パックを参照するには、<feature-pack-location> 要素を使用してその場所を指定します。以下の例は、Maven プラグイン設定ファイルの <feature-pack-location> 要素に org.jboss.eap:wildfly-galleon-pack:4.0.0.GA-redhat-00002 を指定します。
<configuration>
<feature-pack-location>org.jboss.eap:wildfly-galleon-pack:4.0.0.GA-redhat-00002</feature-pack-location>
</configuration>
複数の機能パックを参照する必要がある場合は、それらを <feature-packs> 要素に一覧表示します。以下の例は、Red Hat Single Sign-On 機能パックを <feature-packs> 要素に追加する方法を示しています。
<configuration>
<feature-packs>
<feature-pack>
<location>org.jboss.eap:wildfly-galleon-pack:4.0.0.GA-redhat-00002</location>
</feature-pack>
<feature-pack>
<location>org.keycloak:keycloak-adapter-galleon-pack:15.0.4.redhat-00001</location>
</feature-pack>
</feature-packs>
</configuration>
複数の機能パックから Galleon レイヤーを組み合わせて、起動可能な JAR サーバーを設定し、必要な機能を提供する対応の Galleon レイヤーのみを含めることができます。
ベアメタルプラットフォームで、設定ファイルで Galleon レイヤーを指定しない場合、プロビジョニングしたサーバーにはデフォルトの standalone-microprofile.xml 設定と同じ設定が含まれます。
OpenShift プラットフォームでは、プラグイン設定に <cloud/> 設定要素を追加した後に、設定ファイルで Galleon レイヤーを指定しない場合、プロビジョニングされたサーバーにはクラウド環境用に調整され、デフォルトの standalone-microprofile-ha.xml と似ている設定が含まれます。
前提条件
- Maven がインストールされている。
-
MAVEN_PLUGIN_VERSION.X.GA.Final-redhat-00001などの最新の Maven プラグインバージョンを確認している。MAVEN_PLUGIN_VERSION はメジャーバージョンで、X はマイクロバージョンです。/ga/org/wildfly/plugins/wildfly-jar-maven-plugin のインデックス を参照してください。 -
4.0.X.GA-redhat-BUILD_NUMBERなどの最新の Galleon feature-pack バージョンを確認している。X は JBoss EAP XP のマイクロバージョンで、BUILD_NUMBER は Galleon 機能パックのビルド番号。JBoss EAP XP 4.0.0 製品のライフサイクル中に、X と BUILD_NUMBER の両方を進化できる。Index of /ga/org/jboss/eap/wildfly-galleon-pack のインデックス を参照してください。
この手順の例では、以下のプロパティーを指定します。
-
Maven プラグインバージョンの場合は、
${bootable.jar.maven.plugin.version}です。 -
Galleon 機能パックバージョンの場合は、
${jboss.xp.galleon.feature.pack.version}です。
これらのプロパティーをプロジェクトで設定する必要があります。以下に例を示します。
<properties>
<bootable.jar.maven.plugin.version>6.1.2.Final-redhat-00001</bootable.jar.maven.plugin.version>
<jboss.xp.galleon.feature.pack.version>4.0.0.GA-redhat-00002</jboss.xp.galleon.feature.pack.version>
</properties>
手順
- アプリケーションの実行に必要な機能を提供する、サポートされる JBoss EAP Galleon レイヤーを特定します。
Maven プロジェクトの
pom.xmlファイルの<plugin>要素で JBoss EAP feature-pack の場所を参照します。以下の例のように、最新バージョンの Maven プラグインとorg.jboss.eap:wildfly-galleon-packGalleon 機能パックの最新バージョンを指定する必要があります。以下の例は、jaxrs-serverベースレイヤーおよびjpa-distributeレイヤーを含む単一の 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> <feature-pack-location>org.jboss.eap:wildfly-galleon-pack:${jboss.xp.galleon.feature.pack.version}</feature-pack-location> <layers> <layer>jaxrs-server</layer> <layer>jpa-distributed</layer> </layers> <excluded-layers> <layer>jpa</layer> </excluded-layers> ... </plugins>この例では、プロジェクトからの
jpaレイヤーの除外も示しています。注記jpa-distributedレイヤーをプロジェクトに含める場合は、jaxrs-serverレイヤーからjpaレイヤーを除外する必要があります。jpaレイヤーはローカルの infinispan hibernate キャッシュを設定し、jpa-distributedレイヤーはリモート infinispan hibernate キャッシュを設定します。