8.8. JBoss EAP OpenShift プラットフォームでの起動可能な JAR の使用

手順

1. 以下の内容を pom.xml ファイルの <build> 要素に追加します。最新バージョンの Maven プラグインと、org.jboss.eap:wildfly-galleon-pack Galleon 機能パックの最新バージョンを指定する必要があります。以下に例を示します。

   <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>
               <cloud/>
               </configuration>
               <executions>
                   <execution>
                       <goals>
                           <goal>package</goal>
                       </goals>
                   </execution>
               </executions>
       </plugin>
   </plugins>

   注記

   <cloud/> 要素をプラグイン設定の <configuration> 要素に含める必要があります。そのため、JBoss EAP Maven JAR プラグインは OpenShift プラットフォームを選択できます。

2. アプリケーションをパッケージ化します。

   $ mvn package

3. oc login コマンドを使用して、OpenShift インスタンスにログインします。

4. OpenShift で新しいプロジェクトを作成します。以下に例を示します。

   $ oc new-project bootable-jar-project

5. 以下の oc コマンドを入力してアプリケーションイメージを作成します。

   $ mkdir target/openshift && cp target/microprofile-config-bootable.jar target/openshift  1
   
   $ oc import-image ubi8/openjdk-11 --from=registry.redhat.io/ubi8/openjdk-11 --confirm 2
   
   $ oc new-build --strategy source --binary --image-stream openjdk-11 --name microprofile-config-app 3
   
   $ oc start-build microprofile-config-app --from-dir target/openshift 4

   1

   ターゲットディレクトリーに openshift サブディレクトリーを作成します。パッケージ化されたアプリケーションが、作成されたサブディレクトリーにコピーされます。

   2

   最新の OpenJDK 11 イメージストリームタグおよびイメージ情報を OpenShift プロジェクトにインポートします。

   3

   microprofile-config-app ディレクトリーおよび OpenJDK 11 イメージストリームに基づいてビルド設定を作成します。

   4

   target/openshift サブディレクトリーをバイナリー入力として使用し、アプリケーションをビルドします。

   注記

   OpenShift は CLI スクリプトコマンドのセットを起動可能な JAR 設定ファイルに適用し、クラウド環境に合わせて調整します。このスクリプトにアクセスするには、Maven プロジェクト /target directory の bootable-jar-build-artifacts/generated-cli-script.txt ファイルを開きます。

6. 検証:

   利用可能な OpenShift Pod の一覧を表示し、以下のコマンドを実行して Pod のビルドステータスを確認します。

   $ oc get pods

   ビルドされたアプリケーションイメージを確認します。

   $ oc get is microprofile-config-app

   出力には、名前、イメージリポジトリー、タグなどのビルドされたアプリケーションイメージの詳細が表示されます。この手順の例では、イメージストリーム名とタグの出力には microprofile-config-app:latest が表示されます。

7. アプリケーションをデプロイします。

   重要

   起動可能な JAR にシステムプロパティーを指定するには、JAVA_OPTS_APPEND 環境変数を使用する必要があります。以下の例は、JAVA_OPTS_APPEND 環境変数の使用方法を示しています。

   oc new-app <_IMAGESTREAM_> -e JAVA_OPTS_APPEND="-Xlog:gc*:file=/tmp/gc.log:time -Dwildfly.statistics-enabled=true"

   $ oc new-app microprofile-config-app
   
   $ oc expose svc/microprofile-config-app

   重要

   起動可能な JAR にシステムプロパティーを指定するには、JAVA_OPTS_APPEND 環境変数を使用する必要があります。以下の例は、JAVA_OPTS_APPEND 環境変数の使用方法を示しています。

   $ oc new-app <_IMAGESTREAM_> -e JAVA_OPTS_APPEND="-Xlog:gc*:file=/tmp/gc.log:time -Dwildfly.statistics-enabled=true"

   新しいアプリケーションが作成され、起動します。アプリケーション設定は新しいサービスとして公開されます。

8. 検証: ターミナルで以下のコマンドを実行し、アプリケーションが適切に動作するかどうかをテストします。

   $ curl http://$(oc get route microprofile-config-app --template='{{ .spec.host }}')/config/json

   想定される出力:

   {"result":"Hello jim"}