7.3. EAP Operator を使用した OpenShift での Java アプリケーションデプロイ

手順

1. EAP イメージを OpenShift にインポートします。詳細は、JBoss EAP XP の最新の OpenShift イメージストリームおよびテンプレートのインポート を参照してください。
2. アプリケーションイメージストリームの変更についての更新を受信し、新規ビルドをトリガーするようにイメージストリームを設定します。詳細は、イメージストリームタグの定期的なインポートの設定 を参照してください。

3. EAP S2I イメージを使用してアプリケーションイメージをビルドするための eap-s2i-build テンプレートを作成します。

   $ oc replace --force -f https://raw.githubusercontent.com/jboss-container-images/jboss-eap-openshift-templates/master/eap-s2i-build.yaml

   この eap-s2i-build テンプレートは 2 つのビルド設定と、中間ビルドアーティファクトと最終的なアプリケーションイメージに対応する 2 つのイメージストリームを作成します。

4. 最終的なアプリケーションイメージのリソースを作成するために、パラメーターとともに eap-s2i-build テンプレートを処理します。以下の例は、アプリケーションイメージ my-app を作成します。

   $ oc process eap-s2i-build \
     -p APPLICATION_IMAGE=my-app \ 1
     \
     -p EAP_IMAGE=jboss-eap-xp1-openjdk11-openshift:1.0 \ 2
     -p EAP_RUNTIME_IMAGE=jboss-eap-xp1-openjdk11-runtime-openshift:1.0 \ 3
     -p EAP_IMAGESTREAM_NAMESPACE=$(oc project -q) \ 4
     \
     -p SOURCE_REPOSITORY_URL=https://github.com/jboss-developer/jboss-eap-quickstarts.git \ 5
     -p SOURCE_REPOSITORY_REF=xp-1.0.x \ 6
     -p CONTEXT_DIR=microprofile-config | oc create -f - 7

   1

   アプリケーションイメージストリームの名前。アプリケーションイメージは latest でタグ付けされます。

   2

   EAP ビルダーイメージのイメージストリームタグ。

   3

   EAP ランタイムイメージのイメージストリームタグ。

   4

   Red Hat ミドルウェアイメージのイメージストリームがインストールされている名前空間。省略されている場合、openshift 名前空間が使用されます。これは、openshift 以外の名前空間にイメージストリームをインストールしている場合にのみ変更します。

   5

   アプリケーションの Git ソース URL。

   6

   Git ブランチ/タグリファンレンス

   7

   ビルドするアプリケーションが含まれる Git リポジトリー内のパス。

5. EAP オペレーターを使用して、デプロイメント用にアプリケーションイメージを準備します。

   1. WildFlyServer リソースを設定します。

      $ cat > my-app.yaml<<EOF
      
      apiVersion: wildfly.org/v1alpha1
      kind: WildFlyServer
      metadata:
        name: my-app
      spec:
       applicationImage: 'my-app:latest'
       replicas: 1
      EOF

   2. 設定を適用し、EAP オペレーターがこのアプリケーションイメージを参照する新しい WildFlyServer リソースを作成できるようにします。

      $ oc apply -f my-app.yaml

   3. 以下のコマンドを使用して、WildFlyServer リソースを表示します。

      $ oc get wfly my-app

      関連情報

      • アプリケーションイメージストリームのインポートに関する詳細は、JBoss EAP XP の最新の OpenShift イメージストリームおよびテンプレートのインポート を参照してください。
      • イメージストリームの定期的なインポートについての詳細は、イメージストリームタグの定期的なインポートの設定 を参照してください。

手順

1. Web ブラウザーを開き、OperatorHub にログインします。
2. Java アプリケーションに使用する Project または名前空間を選択します。
3. Installed Operator に移動し、JBoss EAP オペレーターを選択します。
4. Overview タブで、Create Instance リンクをクリックします。

5. アプリケーションイメージの詳細を指定します。

   アプリケーションイメージは、Java アプリケーションが含まれる Docker イメージを指定します。applicationImage フィールドがイメージストリームタグに対応している場合は、イメージへの変更により、アプリケーションの自動アップグレードがトリガーされます。

   JBoss EAP for OpenShift アプリケーションイメージの以下のリファレンスのいずれかを以下のような例で指定できます。

   • イメージの名前: mycomp/myapp
   • タグ: mycomp/myapp:1.0
   • A digest: mycomp/myapp:@sha256:0af38bc38be93116b6a1d86a9c78bd14cd527121970899d719baf78e5dc7bfd2
   • イメージストリームタグ: my-app:latest
   • イメージハッシュ: quay.io/bootable-jar/myapp@sha256:47c06c96e80d0defb777686cdb468c636d9b3b7081a35b784330a050a403e15b

6. アプリケーションのサイズを指定します。例を以下に示します。

   spec:
     replicas:2

   • オプション: アプリケーションのパッケージ化に起動可能な JAR を使用している場合は、以下の例のように表示されます。

     spec:
       bootableJar: true

7. env spec を使用してアプリケーション環境を設定します。環境変数は、POSTGRESQL_SERVICE_HOST などの値や POSTGRESQL_USER などの Secret オブジェクトから直接取得できます。例を以下に示します。

   spec:
     env:
     - name: POSTGRESQL_SERVICE_HOST
       value: postgresql
     - name: POSTGRESQL_SERVICE_PORT
       value: '5432'
     - name: POSTGRESQL_DATABASE
       valueFrom:
         secretKeyRef:
           key: database-name
           name: postgresql
     - name: POSTGRESQL_USER
       valueFrom:
         secretKeyRef:
           key: database-user
           name: postgresql
     - name: POSTGRESQL_PASSWORD
       valueFrom:
         secretKeyRef:
           key: database-password
           name: postgresql

   その他のリソース

   • Java アプリケーションの OpenShift へのデプロイ時に任意の設定を完了する方法は、EAP オペレーターを使用した Java アプリケーションの展開: オプションの設定 を参照してください。
   • eap-s2i-build テンプレートでアプリケーションイメージを構築する方法は、eap-s2i-build テンプレートを使用したアプリケーションイメージのビルド を参照してください。
   • アプリケーションイメージを起動可能な JAR としてパッケージ化する方法は、JBoss EAP OpenShift プラットフォームでの起動可能な JAR の使用 を参照してください。
   • 環境変数の一覧は、環境変数 を参照してください。

手順

1. volumeClaimTemplate を指定し、リソース要件を設定して、JBoss EAP スタンドアロンデータディレクトリーを保存します。テンプレートの名前は JBoss EAP の名前から派生します。対応するボリュームは ReadWriteOnce アクセスモードでマウントされます。

   spec:
     storage:
       volumeClaimTemplate:
         spec:
           resources:
             requests:
               storage: 3Gi

   このストレージ要件を満たす永続ボリュームは、/eap/standalone/data ディレクトリーにマウントされます。