第9章 Jboss EAP アプリケーションの OpenShift Container Platform へのデプロイ

手順

1. OpenShift Container Platform Web コンソールで、Operators→ OperatorHub の順に移動します。
2. 下にスクロールするか、Filter by keyword ボックスに EAP と入力して EAP Operator を見つけます。
3. JBoss EAP Operator を選択し、Install をクリックします。

4. Create Operator Subscription ページで以下を行います。

   1. 以下のいずれかを選択します。

      • クラスター上のすべての名前空間 (デフォルト) では、デフォルトの openshift-operators 名前空間にオペレーターがインストールされ、クラスターのすべての名前空間を監視し、利用できるようにします。このオプションは常に利用できるわけではありません。
      • クラスター上の特定のネームスペース では、選択した特定の単一の名前空間にオペレーターがインストールされます。このオペレーターは、この単一名前空間でのみ使用可能となります。
   2. Update Channel を選択します。
   3. 前述のように、Automatic または Manual 承認ストラテジーを選択します。

5. Subscribe をクリックし、この OpenShift Container Platform クラスターで選択した名前空間で EAP Operator を利用できるようにします。

   1. 手動での承認ストラテジーを選択した場合は、そのインストールプランを確認して承認するまで、サブスクリプションのアップグレードステータスは Upgrading に留まります。Install Plan ページでインストールプランを承認すると、サブスクリプションのアップグレードステータスは Up to date に変わります。
   2. 自動承認ストラテジーを選択した場合は、アップグレードステータスは介入なしで Up to date に変わります。

6. サブスクリプションのアップグレードステータスが Up to date になった後に、Operators Installed Operators の順に選択します。そして、EAP ClusterServiceVersion (CSV) が表示され、関連する名前空間で InstallSucceeded に Status が変わっていることを確認します。

   注記

   All namespace... インストールモードでは、表示されるステータスは openshift-operators 名前空間で InstallSucceeded になります。その他の名前空間では、ステータスは Copied と表示されます。Status フィールドが InstallSucceeded に変更されない場合は、さらにトラブルシューティングを行うために問題のレポートを作成する Workloads Pods ページの openshift-operators プロジェクト (A specific namespace... インストールモードが選択されていた場合は、その他の関連の名前空間) の pod のログを確認してください。

手順

1. OperatorHub からクラスターで利用できる Operator のリストを表示します。

   $ oc get packagemanifests -n openshift-marketplace | grep eap
   NAME        CATALOG               AGE
   ...
   eap         Red Hat Operators     43d
   ...

2. Subscription オブジェクト YAML ファイル (例: eap-operator-sub.yaml) を作成し、namespace を EAP Operator にサブスクライブします。以下は、Subscription オブジェクトの YAML ファイルの例です。

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: eap
     namespace: openshift-operators
   spec:
     channel: stable
     installPlanApproval: Automatic
     name: eap 1
     source:  redhat-operators 2
     sourceNamespace: openshift-marketplace

   1

   サブスクライブするオペレーターの名前。

   2

   EAP Operator は redhat-operators CatalogSource によって提供されます。

   チャネルおよび承認ストラテジーの詳細は、この手順の Web コンソール バージョンを参照してください。

3. YAML ファイルから Subscription オブジェクトを作成します。

   $ oc apply -f eap-operator-sub.yaml
   $ oc get csv -n openshift-operators
   NAME                  DISPLAY     VERSION   REPLACES   PHASE
   eap-operator.v1.0.0   JBoss EAP   1.0.0                Succeeded

   EAP Operator が正常にインストールされます。この時点で、OLM が EAP Operator を認識します。Operator の ClusterServiceVersion (CSV) がターゲット namespace に表示され、EAP Operator が提供する API を作成に使用できるようになります。

手順

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

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

   アプリケーションイメージは、Java アプリケーションが含まれる Docker イメージを指定します。イメージは JBoss EAP for OpenShift の Source-to-Image (S2I) ビルドイメージを使用してビルドする必要があります。applicationImage フィールドがイメージストリームタグに対応している場合は、イメージへの変更により、アプリケーションの自動アップグレードがトリガーされます。

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

   • イメージの名前: mycomp/myapp
   • タグ: mycomp/myapp:1.0
   • A digest: mycomp/myapp:@sha256:0af38bc38be93116b6a1d86a9c78bd14cd527121970899d719baf78e5dc7bfd2
   • イメージストリームタグ: my-app:latest

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

   spec:
     replicas:2

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

8. アプリケーションのデプロイメントに関連する以下のオプションの設定を行います。

   • サーバーデータディレクトリーのストレージ要件を指定します。詳細は、アプリケーションの永続ストレージの設定 を参照してください。

   • WildFlyServerSpec で作成した Secret の名前を指定し、アプリケーションを実行している Pod のボリュームとしてマウントします。以下に例を示します。

     spec:
       secrets:
         - my-secret

     Secret は /etc/secrets/<secret name> にマウントされ、それぞれのキー/ 値がファイルとして保存されます。ファイルの名前がキーに、コンテンツが値になります。Secret は pod 内のボリュームとしてマウントされます。以下の例は、キー値の検索に使用できるコマンドを示しています。

     $ ls /etc/secrets/my-secret/
     my-key  my-password
     $ cat /etc/secrets/my-secret/my-key
     devuser
     $ cat /etc/secrets/my-secret/my-password
     my-very-secure-pasword

     注記

     Secret オブジェクトを変更すると、プロジェクトの一貫性が失われることがあります。Red Hat では、既存の Secret オブジェクトを変更する代わりに、古いオブジェクトと同じコンテンツを持つ新規オブジェクトを作成することを推奨します。これで、必要に応じてコンテンツを更新し、オペレーターカスタムリソース (CR) の参照を更新できます。これは新しい CR 更新とみなされ、pod はリロードされます。

   • WildFlyServerSpec で作成した ConfigMap の名前を指定し、アプリケーションを実行している Pod のボリュームとしてマウントします。以下に例を示します。

     spec:
       configMaps:
       - my-config

     ConfigMap は /etc/configmaps/<configmap name> にマウントされ、それぞれのキー/ 値はファイルとして保存されます。ファイルの名前がキーに、コンテンツが値になります。ConfigMap は pod 内のボリュームとしてマウントされます。キーの値を検索するには、次のコマンドを実行します。

     $ ls /etc/configmaps/my-config/
     key1 key2
     $ cat /etc/configmaps/my-config/key1
     value1
     $ cat /etc/configmaps/my-config/key2
     value2

     注記

     ConfigMap を変更すると、プロジェクトの一貫性が失われることがあります。Red Hat では、既存の ConfigMap オブジェクトを変更する代わりに、古いオブジェクトと同じコンテンツを持つ新しい ConfigMap を作成することを推奨します。これで、必要に応じてコンテンツを更新し、オペレーターカスタムリソース (CR) の参照を更新できます。これは新しい CR 更新とみなされ、pod はリロードされます。

   • 独自のスタンドアロン ConfigMap を選択する場合は、 ConfigMap の名前と standalone.xml ファイルのキーを指定します。

       standaloneConfigMap:
         name: clusterbench-config-map
         key: standalone.xml

     注記

     standalone.xml ファイルからの ConfigMap の作成は、JBoss EAP 8.0 ではサポートされていません。

   • OpenShift でデフォルトの HTTP ルートの作成を無効にする場合は、disableHTTPRoute を true に設定します。

     spec:
       disableHTTPRoute: true

手順

1. OpenShift Container Platform Web コンソールで、Monitoring→ Metrics の順に移動します。
2. Metrics 画面で、テキストボックスにアプリケーションの名前を入力してアプリケーションを選択します。アプリケーションのメトリクスが画面に表示されます。

手順

1. Operators→ Installed Operators ページから、JBoss EAP を選択します。
2. Operator Details ページの右側で、Actions ドロップダウンメニューから Uninstall Operator を選択します。
3. 削除対象のインストールに関連したすべてのコンポーネントが必要であれば、Remove Operator Subscription ウインドウでダイアログが表示されたら、Also completely remove the Operator from the selected namespace チェックボックスを必要に応じて選択します。これにより CSV が削除され、オペレーターに関連付けられた pod、デプロイメント、カスタムリソース定義 (CRD) およびカスタムリソース (CR) が削除されます。
4. Remove をクリックします。EAP Operator が実行を停止し、更新を受信しなくなります。

手順

1. currentCSV フィールドで EAP Operator サブスクリプションの現在のバージョンを確認します。

   $ oc get subscription eap-operator -n openshift-operators -o yaml | grep currentCSV
     currentCSV: eap-operator.v1.0.0

2. EAP Operator のサブスクリプションを削除します。

   $ oc delete subscription eap-operator -n openshift-operators
   subscription.operators.coreos.com "eap-operator" deleted

3. 前のステップの currentCSV 値を使用して、ターゲット namespace の EAP Operator の CSV を削除します。

   $ oc delete clusterserviceversion eap-operator.v1.0.0 -n openshift-operators
   clusterserviceversion.operators.coreos.com "eap-operator.v1.0.0" deleted

手順

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

   apiVersion: wildfly.org/v1alpha1
   kind: WildFlyServer
   metadata:
     name: eap-helloworld
   spec:
     applicationImage: 'eap-helloworld:latest'
     replicas: 1
     resources:
       limits:
         cpu: 500m
         memory: 2Gi
       requests:
         cpu: 100m
         memory: 1Gi

   重要

   自動スケーリングが期待どおりに機能するには、Pod 内のコンテナーのリソース制限とリクエストを指定する必要があります。

2. Horizontal Pod Autoscaler を作成します。

   oc autoscale wildflyserver/eap-helloworld --cpu-percent=50 --min=1 --max=10