第14章 Mave リポジトリーを使用した HA CEP サーバーを実装して KJAR サービスを更新する手順

手順

1. Red Hat カスタマーポータルの Software Downloads ページから製品配信可能ファイル rhdm-7.11.0-reference-implementation.zip をダウンロードします。
2. ファイルの内容を展開してから、rhdm-7.11.0-openshift-drools-hacep-distribution.zip ファイルを展開します。
3. openshift-drools-hacep-distribution/sources ディレクトリーに移動します。
4. sample-hacep-project/sample-hacep-project-kjar ディレクトリー内のサンプルプロジェクトをもとに、サーバーのコードを確認して変更します。複合イベント処理のロジックは、src/main/resources/org/drools/cep サブディレクトリーの DRL ルールで定義します。

5. 標準の Maven コマンドを使用してプロジェクトをビルドします。

   mvn clean install -DskipTests

   Copy to Clipboard Toggle word wrap

   作成した KJAR と必要な依存関係を Maven リポジトリーにアップロードします。

6. Red Hat AMQ Streams 向けの OpenShift operator を有効にして、プロジェクトで AMQ Streams (kafka) クラスターを作成します。Red Hat AMQ Streams のインストールに関する情報は、Using AMQ Streams on OpenShift を参照してください。

7. サーバーの操作に必要な kafka のトピックを作成するには、openshift-drools-hacep-distribution/sources ディレクトリーで、以下のコマンドを実行します。

   oc apply -f kafka-topics/control.yaml
   oc apply -f kafka-topics/events.yaml
   oc apply -f kafka-topics/kiesessioninfos.yaml
   oc apply -f kafka-topics/snapshot.yaml

   Copy to Clipboard Toggle word wrap

8. アプリケーションが、リーダーの選択に使用する ConfigMap にアクセスできるように、ロールベースのアクセス制御を設定します。springboot ディレクトリーに移動して、以下のコマンドを入力します。

   oc create -f kubernetes/service-account.yaml
   oc create -f kubernetes/role.yaml
   oc create -f kubernetes/role-binding.yaml

   Copy to Clipboard Toggle word wrap

   Red Hat OpenShift Container Platform のロールベースのアクセス制御に関する詳細は、Red Hat OpenShift Container Platform 製品ドキュメントの RBAC の使用によるパーミッションの定義および適用 を参照してください。

9. springboot ディレクトリーで pom.xml ファイルを編集して、以下の依存関係を削除します。

   <dependency>
         <groupId>org.kie</groupId>
         <artifactId>sample-hacep-project-kjar</artifactId>
   </dependency>

   Copy to Clipboard Toggle word wrap

10. springboot ディレクトリーで、以下のコマンドを実行してデプロイメント用のイメージを作成し、OpenShift 環境用に設定したリポジトリーにプッシュします。

    oc new-build --binary --strategy=docker --name openshift-kie-springboot
    oc start-build openshift-kie-springboot --from-dir=. --follow

    Copy to Clipboard Toggle word wrap

11. 以下のコマンドを実行して、ビルドしたイメージの名前を検出します。

    oc get is/openshift-kie-springboot -o template --template='{{range .status.tags}}{{range .items}}{{.dockerImageReference}}{{end}}{{end}}'

    Copy to Clipboard Toggle word wrap
12. テキストエディターで kubernetes/deployment.yaml ファイルを開きます。
13. 既存のイメージ URL を直前のコマンドの結果に置き換えます。

14. 文頭に @ の記号がある行の最後にある文字をすべて削除し、その行に :latest を追加します。以下に例を示します。

    image: image-registry.openshift-image-registry.svc:5000/hacep/openshift-kie-springboot:latest

    Copy to Clipboard Toggle word wrap

15. containers: 行と env: 行の下で、以下の例のように環境変数を設定します。

    containers:
      - env:
        - name: UPDATABLEKJAR
          value: "true"
        - name: KJARGAV
          value: <GroupID>:<ArtifactID>:<Version>
        - name: MAVEN_LOCAL_REPO
          value: /app/.m2/repository
        - name: MAVEN_MIRROR_URL
          value: http://<nexus_url>/repository/maven-releases/
        - name: MAVEN_SETTINGS_XML
          value: /app/.m2/settings.xml

    Copy to Clipboard Toggle word wrap

    この例では KJARGAV 変数は、KJAR サービスのグループ、アーティファクト、バージョン (GAV) に置き換え、MAVEN_MIRROR_URL 変数の値は、KJAR サービスを含む Maven リポジトリーの URL に置き換えます。

    必要に応じて他の変数を設定します。サポート対象の環境変数の一覧は、「HA CEP サーバーがサポートする環境変数 (オプション)」 を参照してください。

16. ファイルを保存します。

17. 以下のコマンドを実行してイメージをデプロイします。

    oc apply -f kubernetes/deployment.yaml

    Copy to Clipboard Toggle word wrap