JBoss EAP for OpenShift Container Platform のスタートガイド

1. OpenJDK イメージおよびアーキテクチャー

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

2. OpenShift で新しいプロジェクトを作成します。

   プロジェクトでは、1 つのユーザーグループが他のグループとは別にコンテンツを整理および管理することができます。以下のコマンドを使用すると OpenShift でプロジェクトを作成できます。

   $ oc new-project <project_name>

   Copy to Clipboard Toggle word wrap

   たとえば、以下のコマンドを使用して、kitchensink クイックスタートで eap-demo という名前の新規プロジェクトを作成します。

   $ oc new-project eap-demo

   Copy to Clipboard Toggle word wrap

3. 任意の手順 : キーストアおよびシークレットを作成します。

   注記

   OpenShift プロジェクトで HTTPS 対応の機能を使用する場合、キーストアとシークレットの作成が必要になります。たとえば、eap74-https-s2i テンプレートを使用している場合、キーストアとシークレットを作成する必要があります。

   kitchensink クイックスタートのこのワークフローは、HTTPS テンプレートを使用しないため、キーストアとシークレットは必要ありません。

   1. キーストアを作成します。

      警告

      以下のコマンドは自己署名証明書を生成しますが、本番環境では信用性が確認された認証局 (CA) から購入した独自の SSL 証明書を SSL で暗号化された接続 (HTTPS) に使用することが推奨されます。

      以下のように、Java keytool コマンドを使用して、キーストアを生成することができます。

      $ keytool -genkey -keyalg RSA -alias <alias_name> -keystore <keystore_filename.jks> -validity 360 -keysize 2048

      Copy to Clipboard Toggle word wrap

      たとえば、kitchensink クイックスタートでは、以下のコマンドを使用してキーストアを生成します。

      $ keytool -genkey -keyalg RSA -alias eapdemo-selfsigned -keystore keystore.jks -validity 360 -keysize 2048

      Copy to Clipboard Toggle word wrap

   2. キーストアからシークレットを作成します。

      以下のコマンドを使用して、作成したキーストアからシークレットを作成します。

      $ oc create secret generic <secret_name> --from-file=<keystore_filename.jks>

      Copy to Clipboard Toggle word wrap

      たとえば、kitchensink クイックスタートでは、以下のコマンドを使用してシークレットを作成します。

      $ oc create secret generic eap7-app-secret --from-file=keystore.jks

      Copy to Clipboard Toggle word wrap

1. Red Hat カスタマーポータルの手順にしたがって、レジストリーサービスアカウントを使用して認証トークンを作成します。
2. トークンの OpenShift シークレットが含まれる YAML ファイルをダウンロードします。YAML ファイルは、トークンの Token Information ページの OpenShift Secret タブからダウンロードできます。

3. ダウンロードした YAML ファイルを使用して、OpenShift プロジェクトの認証トークンシークレットを作成します。

   oc create -f 1234567_myserviceaccount-secret.yaml

   Copy to Clipboard Toggle word wrap

4. 例のコマンドを使用して、OpenShift プロジェクトのシークレットを設定します。シークレット名は前のステップで作成したシークレットの名前に置き換えてください。

   oc secrets link default 1234567-myserviceaccount-pull-secret --for=pull
   oc secrets link builder 1234567-myserviceaccount-pull-secret --for=pull

   Copy to Clipboard Toggle word wrap

手順

1. JBoss EAP for OpenShift イメージと Java アプリケーションのソースコードを使用して、新しい OpenShift アプリケーションを作成します。S2I ビルド用に提供される JBoss EAP for OpenShift テンプレートのいずれかを使用できます。トリムされたサーバーのプロビジョニングも選択できます。

   たとえば、JDK 8 ビルダーイメージを使用して kitchensink クイックスタートをディプロイするには、アプリケーションのデプロイメントに向けた OpenShift の準備 で GitHub の kitchensink ソースコードを使用して作成した eap-demo プロジェクトに eap74-basic-s2i テンプレートを使用します。このクイックスタートはトリム機能に対応していません。

   oc new-app --template=eap74-basic-s2i \ 

   1

   
    -p IMAGE_STREAM_NAMESPACE=eap-demo \ 

   2

   
    -p EAP_IMAGE_NAME=jboss-eap74-openjdk8-openshift:7.4.0 \ 

   3

   
    -p EAP_RUNTIME_IMAGE_NAME=jboss-eap74-openjdk8-runtime-openshift:7.4.0 \ 

   4

   
    -p SOURCE_REPOSITORY_URL=https://github.com/jboss-developer/jboss-eap-quickstarts \ 

   5

   
    -p SOURCE_REPOSITORY_REF=7.4.x \ 

   6

   
    -p CONTEXT_DIR=kitchensink 

   7

   Copy to Clipboard Toggle word wrap

   1

   使用するテンプレート。

   2

   最新のイメージとテンプレートは、プロジェクトの namespace にインポートされたため、イメージストリームが見つかる場所の namespace を指定する必要があります。通常はプロジェクトの名前になります。

   3

   JDK8 の EAP ビルダーイメージストリームの名前。

   4

   JDK8 の EAP ランタイムイメージストリームの名前。

   5

   アプリケーションのソースコードが含まれるリポジトリーの URL。

   6

   ソースコードに使用する Git リポジトリー参照。Git ブランチやタグ参照にすることができます。

   7

   ビルドするソースリポジトリー内のディレクトリー。

   別の例として、JDK 11 ランタイムイメージを使用し、JBoss EAP をトリムして helloworld-html5 クイックスタートをデプロイするには jaxrs-server レイヤーのみを含め、以下のコマンドを入力します。このコマンドは、GitHub の helloworld-html5 ソースコードとともに アプリケーションのデプロイメントに向けた OpenShift の準備 で作成した、eap-demo プロジェクトで eap74-basic-s2i テンプレートを使用します。

   oc new-app --template=eap74-basic-s2i \ 

   1

   
    -p IMAGE_STREAM_NAMESPACE=eap-demo \ 

   2

   
    -p EAP_IMAGE_NAME=jboss-eap74-openjdk11-openshift:7.4.0 \ 

   3

   
    -p EAP_RUNTIME_IMAGE_NAME=jboss-eap74-openjdk11-runtime-openshift:7.4.0 \ 

   4

   
    -p SOURCE_REPOSITORY_URL=https://github.com/jboss-developer/jboss-eap-quickstarts \ 

   5

   
    -p SOURCE_REPOSITORY_REF=7.4.x \ 

   6

   
    -p GALLEON_PROVISION_LAYERS=jaxrs-server \ 

   7

   
    -p CONTEXT_DIR=helloworld-html5 

   8

   Copy to Clipboard Toggle word wrap

   1

   使用するテンプレート。

   2

   最新のイメージとテンプレートは、プロジェクトの namespace にインポートされたため、イメージストリームが見つかる場所の namespace を指定する必要があります。通常はプロジェクトの名前になります。

   3

   JDK11 の EAP ビルダーイメージストリームの名前。

   4

   JDK11 の EAP ランタイムイメージストリームの名前。

   5

   アプリケーションのソースコードが含まれるリポジトリーの URL。

   6

   ソースコードに使用する Git リポジトリー参照。Git ブランチやタグ参照にすることができます。

   7

   jaxrs-server レイヤーのみを持つトリムされたサーバーをプロビジョニングします。

   8

   ビルドするソースリポジトリー内のディレクトリー。

   注記

   新しい OpenShift アプリケーションを作成するときに、環境変数を設定 することもあります。

   たとえば、eap74-https-s2i などの HTTPS テンプレートを使用している場合は、必要な HTTPS 環境変数 である HTTPS_NAME、HTTPS_PASSWORD、および HTTPS_KEYSTORE を指定し、キーストアの詳細と一致するようにする必要があります。

   注記

   テンプレートで AMQ が使用される場合は、AMQ_IMAGE_NAME パラメーターに適切な値を含める必要があります。

   テンプレートが SSO を使用する場合は、適切な値を指定して SSO_IMAGE_NAME パラメーターを含める必要があります。

2. ビルド設定の名前を取得します。

   $ oc get bc -o name

   Copy to Clipboard Toggle word wrap

3. 取得したビルド設定の名前を使用し、Maven のビルドの進捗を表示します。

   $ oc logs -f buildconfig/BUILD_CONFIG_NAME

   Copy to Clipboard Toggle word wrap

   たとえば、kitchensink クイックスタートでは、以下のコマンドで Maven ビルドの進捗を表示します。

   $ oc logs -f buildconfig/eap-app

   Copy to Clipboard Toggle word wrap

1. 以下のコマンドを使用してアプリケーションのサービス名を取得します。

   $ oc get service

   Copy to Clipboard Toggle word wrap

2. メインサービスをルートとして公開し、OpenShift 外部からアプリケーションにアクセスできるようにします。たとえば、kitchensink クイックスタートでは、以下のコマンドを使用して必要なサービスとポートを公開します。

   $ oc expose service/eap-app --port=8080

   Copy to Clipboard Toggle word wrap
   注記

   テンプレートを使用してアプリケーションを作成した場合は、ルートがすでに存在することがあります。存在する場合は次のステップに進みます。

3. ルートの URL を取得します。

   $ oc get route

   Copy to Clipboard Toggle word wrap

4. この URL を使用して web ブラウザーでアプリケーションにアクセスします。URL は前のコマンド出力にある HOST/PORT フィールドの値になります。

   アプリケーションが JBoss EAP ルートコンテキストを使用しない場合、アプリケーションのコンテキストを URL に追加します。たとえば、kitchensink クイックスタートでは、URL は http://HOST_PORT_VALUE/kitchensink/ のようになります。

5. 任意で、以下のコマンドを実行してアプリケーションインスタンスをスケールアップすることもできます。これは、レプリカの数を 3 に増やします。

   $ oc scale deploymentconfig DEPLOYMENTCONFIG_NAME --replicas=3

   Copy to Clipboard Toggle word wrap

   たとえば、kitchensink クイックスタートでは、以下のコマンドを使用してアプリケーションをスケールアップします。

   $ oc scale deploymentconfig eap-app --replicas=3

   Copy to Clipboard Toggle word wrap

手順

1. メインナビゲーションで、ドロップダウンメニューをクリックして、Developer を選択します。

2. ナビゲーションメニューで Add をクリックします。

   Add ページが開きます。

3. Add ページで、Helm Chart をクリックします。
4. Helm Charts カタログで、JBoss EAP 7.4 を検索します。

5. JBoss EAP 7.4 Helm チャートタイルをクリックします。

   サイドパネルには、JBoss EAP 7 Helm チャートに関する情報が表示されます。

6. Install Helm Chart をクリックします。

   一部のフォームセクションはデフォルトで折りたたまれています。> をクリックしてデプロイし、内容を表示します。

   注記

   続行するためにこれらのセクションを更新する必要はありません。

   構築およびデプロイしている Jakarta EE アプリケーションの詳細は、build.uri フィールドに指定されます。

   build:
     uri: https://github.com/jboss-eap-up-and-running/eap7-getting-started

   Copy to Clipboard Toggle word wrap
   注記

   別のアプリケーションを構築している場合は、そのアプリケーションの Git リポジトリーを指すようにこの uri フィールドを変更する必要があります。

7. Install をクリックして、Helm チャートを使用して JBoss EAP 7 アプリケーションを作成します。

手順

1. ナビゲーションメニューで、Helm をクリックします。

2. eap74 Helm リリース をクリックします。

   Helm Release details ページが開きます。インストールした Helm リリースに関連するすべての情報が表示されます。

3. Resources タブをクリックします。この Helm リリースで作成されたすべてのリソースがリストされます。

手順

1. ナビゲーションメニューで、Topology をクリックします。

   トポロジービュー では、eap74 デプロイメントの右下隅にコードアイコンが表示されます。

   このアイコンは、関連するコードの Git リポジトリーを表すか、適切な operator がインストールされている場合は、IDE で関連するコードを表示します。

2. 表示されているアイコンが CodeReady Workspaces または Eclipse Che の場合は、それをクリックして関連するコードを IDE に表示します。それ以外の場合は、クリックして関連する Git リポジトリーに移動します。

手順

1. ナビゲーションメニューで、トポロジー をクリックします。

2. Topology ビューで、D eap74 アイコンをクリックします。

   サイドパネルが開き、アプリケーションに関する詳細情報が表示されます。

3. サイドパネルで、Resources タブをクリックします。Builds セクションには、アプリケーションのビルドに関連するすべての詳細が表示されます。

手順

1. ナビゲーションメニューで、Topology をクリックします。

2. Topology ビューで、D eap74 をクリックします。

   サイドパネルが開き、アプリケーションに関する詳細情報が表示されます。

3. 詳細タブで Pod の上にマウスを置くと、ツールチップで Pod のステータスが表示されます。

   • Pod の数は Pod の円の内側に表示されます。

   • Pod の円の色は Pod のステータスを示します。Light blue = Pending、Blue = Not Ready、Dark blue = Running。

     注記

     Topology ビューでは、D eap74 デプロイメントアイコンの外側の黒い円も Pod のステータスを示します。

1. pom.xml ファイルがソースコードリポジトリーにある場合、S2I ビルダーイメージは Maven ビルドプロセスを開始します。Maven ビルドは $MAVEN_ARGS の内容を使用します。

   pom.xml ファイルがソースコードリポジトリーにない場合、S2I ビルダーイメージはバイナリータイプのビルドを開始します。

   カスタム Maven 引数またはオプションを追加するには、$MAVEN_ARGS_APPEND を使用します。$MAVEN_ARGS_APPEND 変数は、$MAVEN_ARGS にオプションを追加します。

   デフォルトでは、OpenShift プロファイルは Maven の package ゴールを使用します。これには、テストをスキップするシステムプロパティー (-DskipTests) や Red Hat GA リポジトリーを有効にするシステムプロパティー (-Dcom.redhat.xpaas.repo) が含まれます。

   成功した Maven ビルドの結果は、JBoss EAP for OpenShift イメージ内の EAP_HOME/standalone/deployments/ ディレクトリーにコピーされます。これには、$ARTIFACT_DIR 環境変数によって指定されたソースリポジトリーからの JAR、WAR、および EAR ファイルがすべて含まれます。$ARTIFACT_DIR のデフォルト値は Maven のターゲットディレクトリーです。

   注記

   JBoss EAP for OpenShift イメージのプロキシーの背後で Maven を使用するには、$HTTP_PROXY_HOST および $HTTP_PROXY_PORT 環境変数を設定します。任意で、$HTTP_PROXY_USERNAME、$HTTP_PROXY_PASSWORD、および $HTTP_PROXY_NONPROXYHOSTS 変数を設定することもできます。

2. modules ソースリポジトリーディレクトリーのすべてのファイルは、JBoss EAP for OpenShift イメージ内の EAP_HOME/modules/ ディレクトリーにコピーされます。
3. configuration ソースリポジトリーディレクトリーのすべてのファイルは、JBoss EAP for OpenShift イメージ内の EAP_HOME/standalone/configuration/ ディレクトリーにコピーされます。カスタムの JBoss EAP 設定ファイルを使用する場合は、ファイル名を standalone-openshift.xml にする必要があります。

手順

1. Galleon Maven プラグインを使用してカスタムレイヤーを構築します。

   詳細は、Maven プロジェクトの準備 を参照してください。

2. アクセス可能な Maven リポジトリーにカスタムレイヤーをデプロイします。

3. カスタム Galleon 機能パック環境変数を使用して、S2I イメージビルドプロセス中に Galleon 機能パックとレイヤーをカスタマイズできます。

   Galleon 機能パックとレイヤーのカスタマイズの詳細は、S2I ビルド中におけるカスタム Galleon 機能パックの使用 を参照してください。

4. オプション: ユーザー定義のレイヤーとサポートされる JBoss EAP レイヤーを参照するカスタムプロビジョニングファイルを作成し、これをアプリケーションディレクトリーに保存します。

   カスタムプロビジョニングファイルの作成に関する詳細は、JBoss EAP のカスタムプロビジョニングファイル を参照してください。

5. S2I プロセスを実行して、OpenShift で JBoss EAP サーバーをプロビジョニングします。

   詳細は、S2I ビルド中におけるカスタム Galleon 機能パックをの使用 を参照してください。

1. 問題のある Pod の名前を取得します。

   以下のコマンドを使用すると、Pod の名前と、各 Pod が再起動した回数を確認することができます。

   $ oc get pods

   Copy to Clipboard Toggle word wrap

2. Pod が再起動した理由を診断するには、前の Pod の JBoss EAP ログまたは OpenShift イベントを調べます。

   1. 前の Pod の JBoss EAP ログを表示するには、以下のコマンドを使用します。

      oc logs --previous POD_NAME

      Copy to Clipboard Toggle word wrap

   2. OpenShift イベントを表示するには、以下のコマンドを使用します。

      $ oc get events

      Copy to Clipboard Toggle word wrap
3. リソースの問題により Pod が再起動される場合は、OpenShift Pod 設定を変更して、その リソース要求および制限 を引き上げることができます。Pod コンピュートリソースの設定 についての詳細は、OpenShift ドキュメントを参照してください。

1. 最初に、実行中の Pod にリモートシェルセッションを開きます。

   $ oc rsh POD_NAME

   Copy to Clipboard Toggle word wrap

2. リモートシェルセッションから以下のコマンドを実行し、JBoss EAP 管理 CLI を起動します。

   $ /opt/eap/bin/jboss-cli.sh

   Copy to Clipboard Toggle word wrap

手順

1. OpenShift Container Platform Web コンソールで、Operators→ OperatorHub の順に移動します。
2. 下にスクロールするか、Filter by keyword ボックスに EAP と入力して EAP オペレーターを見つけます。
3. JBoss EAP オペレーターを選択し、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 と表示されます。

7. 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
   ...

   Copy to Clipboard Toggle word wrap

2. Subscription オブジェクト YAML ファイル (例: eap-operator-sub.yaml) を作成し、名前空間を EAP オペレーターにサブスクライブします。以下は、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

   Copy to Clipboard Toggle word wrap

   1

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

   2

   EAP オペレーターは 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

   Copy to Clipboard Toggle word wrap

   EAP オペレーターが正常にインストールされます。この時点で、OLM は EAP のオペレーターを認識します。オペレーターの ClusterServiceVersion (CSV) がターゲット名前空間に表示され、EAP オペレーターによって提供される API は作成に利用できます。

手順

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

   Copy to Clipboard Toggle word wrap

   この 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

   Copy to Clipboard Toggle word wrap

   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

      Copy to Clipboard Toggle word wrap

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

      $ oc apply -f my-app.yaml

      Copy to Clipboard Toggle word wrap

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

      $ oc get wfly my-app

      Copy to Clipboard Toggle word wrap

      関連情報

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

手順

1. Web ブラウザーを開き、OperatorHub にログインします。
2. Java アプリケーションに使用する Project または名前空間を選択します。
3. Installed Operator に移動し、JBoss EAP オペレーターを選択します。
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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

   • サーバーデータディレクトリーのストレージ要件を指定します。詳細は、Configuring Persistent Storage for Applications を参照してください。

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

     spec:
       secrets:
         - my-secret

     Copy to Clipboard Toggle word wrap

     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

     Copy to Clipboard Toggle word wrap
     注記

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

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

     spec:
       configMaps:
       - my-config

     Copy to Clipboard Toggle word wrap

     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

     Copy to Clipboard Toggle word wrap
     注記

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

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

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

     Copy to Clipboard Toggle word wrap
     注記

     JBoss EAP 7 では、standalone.xml ファイルから ConfigMap を作成することはできません。

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

     spec:
       disableHTTPRoute: true

     Copy to Clipboard Toggle word wrap

手順

1. eap74-sso-s2i テンプレートによって作成された DeploymentConfig ファイルを、EAP アプリケーションイメージを構築した場所から削除します。

2. EAP オペレーターの WildFlyServer リソースの env フィールドで、すべての 環境変数とシークレット を設定します。

   設定例

   $ cat > my-app.yaml<<EOF
   
   apiVersion: wildfly.org/v1alpha1
   kind: WildFlyServer
   metadata:
     name: my-app
   spec:
     applicationImage: 'my-app:latest'
     replicas: 1
   
     env:
     - name: SSO_URL
       value: https://secure-sso-sso-app-demo.openshift32.example.com/auth
     - name: SSO_REALM
       value: eap-demo
     - name: SSO_PUBLIC_KEY
       value: realm-public-key
     - name: SSO_USERNAME
       value: mySsoUser
     - name: SSO_PASSWORD
       value: 6fedmL3P
     - name: SSO_SAML_KEYSTORE
       value: /etc/secret/sso-app-secret/keystore.jks
     - name: SSO_SAML_KEYSTORE_PASSWORD
       value: mykeystorepass
     - name: SSO_SAML_CERTIFICATE_NAME
       value: jboss
     - name: SSO_BEARER_ONLY
       value: true
     - name: SSO_CLIENT
       value: module-name
     - name: SSO_ENABLE_CORS
       value: true
     - name: SSO_SECRET
       value: KZ1QyIq4
     - name: SSO_DISABLE_SSL_CERTIFICATE_VALIDATION
       value: true
     - name: SSO_SAML_KEYSTORE_SECRET
       value: sso-app-secret
     - name: HTTPS_SECRET
       value: eap-ssl-secret
     - name: SSO_TRUSTSTORE_SECRET
       value: sso-app-secret
   EOF

   Copy to Clipboard Toggle word wrap

   注記
   • すべての環境変数とシークレットがイメージ設定と一致していることを確認してください。
   • パラメーター SSO_URL の値は、OpenShift クラスターのユーザーによって異なります。
   • EAP Operator はシークレットを /etc/secret ディレクトリーにマウントしますが、eap74-sso テンプレートはシークレットを /etc ディレクトリーにマウントします。
3. EAP オペレーターの WildFlyServer リソース設定を保存します。

手順

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

手順

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 オペレーターは実行を停止し、更新を受信しなくなります。

手順

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

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

   Copy to Clipboard Toggle word wrap

2. EAP オペレーターのサブスクリプションを削除します。

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

   Copy to Clipboard Toggle word wrap

3. 前回の手順の currentCSV 値を使用し、ターゲット名前空間で EAP オペレーターの CSV を削除します。

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

   Copy to Clipboard Toggle word wrap

手順

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

   Copy to Clipboard Toggle word wrap
   重要

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

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

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

   Copy to Clipboard Toggle word wrap