8.5. JBoss EAP ベアメタルプラットフォームでの起動可能な JAR の使用
JBoss EAP ベアメタルプラットフォームで、アプリケーションを起動可能な JAR としてパッケージ化できます。
起動可能な JAR には、サーバー、パッケージ化されたアプリケーション、およびサーバー起動に必要なランタイムが含まれます。
この手順では、JBoss EAP JAR Maven プラグインを使用して MicroProfile Config マイクロサービスを起動可能な JAR としてパッケージ化する方法を説明します。MicroProfile Config の開発 を参照してください。
起動可能な JAR のパッケージング時に CLI スクリプトを使用してサーバーを設定できます。
起動可能な JAR 内にパッケージ化する必要がある Web アプリケーションのビルドでは、pom.xml ファイルの <packaging> 要素に war を指定する必要があります。以下に例を示します。
<packaging>war</packaging>
この値は、ビルドアプリケーションを、デフォルトの JAR ファイルとしてではなく、WAR ファイルとしてパッケージ化するのに必要です。
起動可能な hollow JAR をビルドするためだけに Maven プロジェクトで使用される Maven プロジェクトで、packaging の値を pom に設定します。以下に例を示します。
<packaging>pom</packaging>
Maven プロジェクトの hollow JAR をビルドする場合は、pom パッケージングの使用に限定されません。war などのパッケージ化の種類について <hollow-jar> 要素に true を指定すると作成できます。Creating a hollow bootable JAR on a JBoss EAP baremetal platform を参照してください。
前提条件
-
MAVEN_PLUGIN_VERSION.X.GA.Final-redhat-00001などの最新の Maven プラグインバージョンを確認している。MAVEN_PLUGIN_VERSION はメジャーバージョンで、X はマイクロバージョンです。/ga/org/wildfly/plugins/wildfly-jar-maven-plugin のインデックス を参照してください。 -
3.0.X.GA-redhat-BUILD_NUMBERなどの最新の Galleon feature-pack バージョンを確認している。X は JBoss EAP XP のマイクロバージョンで、BUILD_NUMBER は Galleon 機能パックのビルド番号。JBoss EAP XP 3.0.0 製品のライフサイクル中に、X と BUILD_NUMBER の両方を進化できます。Index of /ga/org/jboss/eap/wildfly-galleon-pack のインデックス を参照してください。 - Maven プロジェクトを作成し、親依存関係を設定して、MicroProfile アプリケーションを作成するための依存関係を追加している。MicroProfile Config の開発 を参照してください。
この手順の例では、以下のプロパティーを指定します。
-
Maven プラグインバージョンの場合は、
${bootable.jar.maven.plugin.version}です。 -
Galleon 機能パックバージョンの場合は、
${jboss.xp.galleon.feature.pack.version}です。
これらのプロパティーをプロジェクトで設定する必要があります。以下に例を示します。
<properties>
<bootable.jar.maven.plugin.version>4.0.3.Final-redhat-00001</bootable.jar.maven.plugin.version>
<jboss.xp.galleon.feature.pack.version>3.0.0.GA-redhat-00001</jboss.xp.galleon.feature.pack.version>
</properties>
手順
以下の内容を
pom.xmlファイルの<build>要素に追加します。最新バージョンの Maven プラグインと、org.jboss.eap:wildfly-galleon-packGalleon 機能パックの最新バージョンを指定する必要があります。以下に例を示します。<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>microprofile-platform</layer> </layers> </configuration> <executions> <execution> <goals> <goal>package</goal> </goals> </execution> </executions> </plugin> </plugins>注記pom.xmlファイルで Galleon レイヤーを指定しない場合、起動可能な JAR サーバーにはstandalone-microprofile.xml設定と同じ設定が含まれます。アプリケーションを起動可能な JAR としてパッケージ化します。
$ mvn packageアプリケーションを起動します。
$ NAME="foo" java -jar target/microprofile-config-bootable.jar注記この例では、環境変数に
NAMEを使用しますが、デフォルト値のjimを使用することができます。注記サポートされる起動可能な JAR 引数の一覧を表示するには、
--helpをjava -jar target/microprofile-config-bootable.jarコマンドの最後に追加します。Web ブラウザーで以下の URL を指定して MicroProfile Config アプリケーションにアクセスします。
http://localhost:8080/config/json検証: ターミナルで以下のコマンドを実行し、アプリケーションが適切に動作します。
curl http://localhost:8080/config/json以下が想定される出力です。
{"result":"Hello foo"}