Red Hat Process Automation Manager での Red Hat build of Kogito の使用

手順

1. VS Code IDE で Extensions メニューオプションを選択し、DMN、BPMN、およびテストシナリオファイルのサポートに対して Red Hat Business Automation Bundle を検索します。

   DMN ファイルまたは BPMN ファイルだけをサポートする場合は、DMN Editor または BPMN Editor 拡張機能をそれぞれ検索することもできます。

2. Red Hat Business Automation Bundle 拡張機能が VS Code に表示される際に、これを選択し、Install をクリックします。
3. VS Code エディターの動作を最適化するには、拡張機能のインストールが完了した後に、VS Code のインスタンスを再度読み込み、閉じるか、再起動します。

手順

1. 以下の方法のいずれかを使用して、スタンドアロンのエディターをインストールします。

   各 JavaScript ファイルを手動でダウンロード: この方法の場合は、以下の手順に従います。

   1. JavaScript ファイルをダウンロードします。
   2. ダウンロードした Javascript ファイルをホスト型アプリケーションに追加します。

   3. 以下の <script> タグを HTML ページに追加します。

      DMN エディターの HTML ページのスクリプトタグ

      <script src="https://<YOUR_PAGE>/dmn/index.js"></script>

      Copy to Clipboard Toggle word wrap

      BPMN エディターの HTML ページのスクリプトタグ

      <script src="https://<YOUR_PAGE>/bpmn/index.js"></script>

      Copy to Clipboard Toggle word wrap

   NPM パッケージの使用: この方法の場合は、以下の手順に従います。

   1. NPM パッケージを package.json ファイルに追加します。

      NPM パッケージの追加

      npm install @kie-tools/kie-editors-standalone

      Copy to Clipboard Toggle word wrap

   2. 各エディターライブラリーを TypeScript ファイルにインポートします。

      各エディターのインポート

      import * as DmnEditor from "@kie-tools/kie-editors-standalone/dist/dmn"
      import * as BpmnEditor from "@kie-tools/kie-editors-standalone/dist/bpmn"

      Copy to Clipboard Toggle word wrap

2. スタンドアロンのエディターをインストールしたら、以下の例のように提供されたエディター API を使用して必要なエディターを開き、DMN エディターを開きます。API は、各エディターで同じものになります。

   DMN スタンドアロンのエディターを開く

   const editor = DmnEditor.open({
     container: document.getElementById("dmn-editor-container"),
     initialContent: Promise.resolve(""),
     readOnly: false,
     origin: "",
     resources: new Map([
       [
         "MyIncludedModel.dmn",
         {
           contentType: "text",
           content: Promise.resolve("")
         }
       ]
     ])
   });

   Copy to Clipboard Toggle word wrap

   エディター API で以下のパラメーターを使用します。

   Expand

   表2.1 パラメーターの例

   パラメーター	説明
   container	エディターが追加される HTML 要素。
   initialContent	DMN モデルのコンテンツへの Promise。以下の例のように、このパラメーターは空にすることができます。 Promise.resolve("") Promise.resolve("<DIAGRAM_CONTENT_DIRECTLY_HERE>") fetch("MyDmnModel.dmn").then(content ⇒ content.text())
   readOnly (任意)	エディターでの変更を許可します。コンテンツの編集を許可する場合は false (デフォルト)、エディターで読み取り専用モードの場合は true に設定します。
   origin (任意)	リポジトリーの起点。デフォルト値は window.location.origin です。
   resources (任意)	エディターのリソースのマッピング。たとえば、このパラメーターを使用して、BPMN エディターの DMN エディターまたは作業アイテム定義に含まれるモデルを提供します。マップの各エントリーには、リソース名と、content-type (text または binary) および content (initialContent パラメーターと同様) で構成されるオブジェクトが含まれています。

   Show more

   返されるオブジェクトには、エディターの操作に必要なメソッドが含まれます。

   Expand

   表2.2 返されたオブジェクトメソッド

   メソッド	説明
   getContent(): Promise<string>	エディターのコンテンツを含む promise を返します。
   setContent(path: string, content: string): void	エディターの内容を設定します。
   getPreview(): Promise<string>	現在のダイアグラムの SVG 文字列が含まれる promise を返します。
   subscribeToContentChanges(callback: (isDirty: boolean) ⇒ void): (isDirty: boolean) ⇒ void	エディターでコンテンツを変更し、サブスクライブ解除に使用されるのと同じコールバックを返す際に呼び出されるコールバックを設定します。
   unsubscribeToContentChanges(callback: (isDirty: boolean) ⇒ void): void	エディターでコンテンツが変更される際に渡されたコールバックのサブスクライブを解除します。
   markAsSaved(): void	エディターの内容が保存されることを示すエディターの状態をリセットします。また、コンテンツの変更に関連するサブスクライブされたコールバックをアクティベートします。
   undo(): void	エディターの最後の変更を元に戻します。また、コンテンツの変更に関連するサブスクライブされたコールバックをアクティベートします。
   redo(): void	エディターで、最後に元に戻した変更をやり直します。また、コンテンツの変更に関連するサブスクライブされたコールバックをアクティベートします。
   close(): void	エディターを終了します。
   getElementPosition(selector: string): Promise<Rect>	要素をキャンバスまたはビデオコンポーネント内に置いた場合に、標準のクエリーセレクターを拡張する方法を提供します。selector パラメーターは、Canvas:::MySquare、Video:::PresenterHand などの <PROVIDER>:::<SELECT> 形式に従う必要があります。このメソッドは、要素の位置を表す Rect を返します。
   envelopeApi: MessageBusClientApi<KogitoEditorEnvelopeApi>	これは高度なエディター API です。高度なエディター API の詳細は、MessageBusClientApi および KogitoEditorEnvelopeApi を参照してください。

   Show more

手順

1. コマンドターミナルで、新しプロジェクトを保存するローカルディレクトリーに移動します。

2. 以下のいずれかのコマンドを実行して、starters または addons プロパティーを使用してプロジェクトを生成します。

   • starters プロパティーを使用してプロジェクトを生成するには、以下のコマンドを入力します。

     $ mvn archetype:generate \
         -DarchetypeGroupId=org.kie.kogito \
         -DarchetypeArtifactId=kogito-springboot-archetype \
         -DgroupId=org.acme -DartifactId=sample-kogito \
         -DarchetypeVersion=1.11.0.Final \
         -Dversion=1.0-SNAPSHOT
         -Dstarters=decisions

     Copy to Clipboard Toggle word wrap

     新しいプロジェクトには、決定マイクロサービスを実行するために必要な依存関係が含まれています。starters=decisions,rules などのコンマ区切りリストを使用して、複数の Spring Boot スターターを組み合わせることができます。

   • addons プロパティーを使用して Prometheus モニタリングが含まれるプロジェクトを生成するには、以下のコマンドを入力します。

     $ mvn archetype:generate \
         -DarchetypeGroupId=org.kie.kogito \
         -DarchetypeArtifactId=kogito-springboot-archetype \
         -DgroupId=org.acme -DartifactId=sample-kogito \
         -DarchetypeVersion=1.11.0.Final \
         -Dversion=1.0-SNAPSHOT
         -Dstarters=descisions
         -Daddons=monitoring-prometheus,persistence-infinispan

     Copy to Clipboard Toggle word wrap
     注記

     アドオンをプロパティーに渡すと、アドオン名には kogito-addons-springboot 接頭辞は必要ありません。また、add-ons と starters プロパティーを組み合わせてプロジェクトをカスタマイズすることもできます。

3. IDE でプロジェクトを開くか、インポートしてコンテンツを表示します。

手順

1. DMN ファイルを使用する代わりに、サンプルプロジェクトの src/main/resources ディレクトリーに、以下の PersonRules.drl ファイルを追加します。

   PersonRules DRL ファイルの例

   package org.acme
   unit PersonRules;
   
   import org.acme.Person;
   
   rule isAdult
   	when
   		$person: /person[ age > 18 ]
   	then
       modify($person) {
       	setAdult(true)
       };
   	end
   
   	query persons
   		$p : /person[ adult ]
   		end

   Copy to Clipboard Toggle word wrap

   このルールの例では、18 歳以上を成人として分類しているかどうかを判断します。また、ルールファイルは、ルールがルールユニット PersonRules に属することを宣言します。プロジェクトをビルドすると、ルールユニットが生成され、DRL ファイルに関連付けられます。

   ルールは OOPath 表記を使用して条件も定義します。OOPath は、Xpath のオブジェクト指向の構文拡張で、コレクションおよびフィルター制約を処理しながら、関連要素間を移動します。

   以下の例のように、従来のルールパターン構文を使用して、より明示的な形式で同じルール条件を再書き込みすることもできます。

   従来の表記を使用した PersonRules DRL ファイルの例

   package org.acme
   unit PersonRules;
   
   import org.acme.Person;
   
   rule isAdult
   	when
   		$person: Person(age > 18) from person
   	then
       modify($person) {
       	setAdult(true)
       };
   	end
   
   	query persons
   		$p : /person[ adult ]
   		end

   Copy to Clipboard Toggle word wrap

手順

1. クラスパスに META-INF/services/org.kie.kogito.add-on.cloudevents.message.MessagePayloadDecorator という名前のファイルを作成します。
2. ファイルを開きます。
3. ファイルに実装クラスのフルネームを入力します。

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

   MessagePayloadDecoratorProvider は、アプリケーションの起動時にファイルをロードし、ファイルを装飾チェーンに追加します。Red Hat build of Kogito が MessagePayloadDecoratorProvider#decorate を呼び出す場合、実装は装飾アルゴリズムの一部です。

5. イベントアドオンを使用するには、プロジェクトの pom.xml ファイルに次のコードを追加します。

   {QAURKUS} のイベント smallrye アドオン

   <dependency>
     <groupId>org.kie.kogito</groupId>
     <artifactId>kogito-addons-quarkus-events-smallrye</artifactId>
     <version>1.15</version>
   </dependency>

   Copy to Clipboard Toggle word wrap

   {QAURKUS} のイベント決定アドオン

   <dependency>
     <groupId>org.kie.kogito</groupId>
     <artifactId>kogito-addons-events-decisions</artifactId>
     <version>1.15</version>
   </dependency>

   Copy to Clipboard Toggle word wrap

   Spring Boot 用のイベント Kafka アドオン

   <dependency>
     <groupId>org.kie.kogito</groupId>
     <artifactId>kogito-addons-springboot-events-kafka</artifactId>
     <version>1.15</version>
   </dependency>

   Copy to Clipboard Toggle word wrap

   Spring Boot のイベント決定アドオン

   <dependency>
     <groupId>org.kie.kogito</groupId>
     <artifactId>kogito-addons-springboot-events-decisions</artifactId>
     <version>1.15</version>
   </dependency>

   Copy to Clipboard Toggle word wrap

手順

1. Operators → Installed Operators に移動し、RHPAM Kogito Operator を選択します。
2. Red Hat build of Kogito ビルド定義を作成するには、Operator ページで Kogito Build タブを選択し、Create KogitoBuild をクリックします。

3. アプリケーションウィンドウで、Form View または YAML View を使用してビルド定義を設定します。

   少なくとも、以下の YAML ファイルのサンプルに示されるようにアプリケーション設定を定義します。

   Red Hat build of Kogito ビルドを使用した Red Hat build of Quarkus アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-quarkus  # Application name
   spec:
     type: RemoteSource
     gitSource:
       uri: 'https://github.com/kiegroup/kogito-examples'  # Git repository containing application (uses default branch)
       contextDir: dmn-quarkus-example  # Git folder location of application

   Copy to Clipboard Toggle word wrap

   Red Hat build of Kogito ビルドを使用した Spring Boot アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot
     type: RemoteSource
     gitSource:
       uri: 'https://github.com/kiegroup/kogito-examples'  # Git repository containing application (uses default branch)
       contextDir: dmn-springboot-example  # Git folder location of application

   Copy to Clipboard Toggle word wrap

   注記

   内部 Maven リポジトリーを設定した場合は、Maven ミラーサービスとして使用でき、Red Hat build of Kogito ビルド定義に Maven ミラー URL を指定して、ビルド時間を大幅に短縮できます。

   spec:
     mavenMirrorURL: http://nexus3-nexus.apps-crc.testing/repository/maven-public/

   Copy to Clipboard Toggle word wrap

   内部 Maven リポジトリーの詳細は、Apache Maven ドキュメントを参照してください。

4. アプリケーションデータを定義したら、Create をクリックして Red Hat build of Kogito ビルドを生成します。

   アプリケーションが Red Hat build of KogitoBuilds ページに一覧表示されます。アプリケーション名を選択して、アプリケーション設定および YAML の詳細を表示または変更できます。

5. Red Hat build of Kogito マイクロサービス定義を作成するには、Operator ページで Kogito Runtime タブを選択し、Create KogitoRuntime をクリックします。

6. アプリケーションウィンドウで、Form View または YAML View を使用してマイクロサービス定義を設定します。

   少なくとも、以下の YAML ファイルのサンプルに示されるようにアプリケーション設定を定義します。

   Red Hat build of Kogito マイクロサービスを使用した Red Hat build of Quarkus アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-quarkus  # Application name

   Copy to Clipboard Toggle word wrap

   Red Hat build of Kogito マイクロサービスを使用した Spring Boot アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot

   Copy to Clipboard Toggle word wrap

   注記

   この場合、アプリケーションは Git からビルドされ、KogitoRuntime を使用してデプロイされます。アプリケーション名が KogitoBuild および KogitoRuntime で同じである必要があります。

7. アプリケーションデータを定義したら、Create をクリックして Red Hat build of Kogito マイクロサービスを生成します。

   アプリケーションが Red Hat build of Kogito マイクロサービスページに一覧表示されます。アプリケーション名を選択して、アプリケーション設定や YAML ファイルの内容を表示または変更できます。

8. Web コンソールの左側のメニューで Builds → Builds に移動して、アプリケーションのビルドのステータスを表示します。

   特定のビルドを選択して、ビルドの詳細を表示できます。

   注記

   OpenShift デプロイメント用に作成するすべての Red Hat build of Kogito マイクロサービスでは、従来のランタイムビルドと S2I (接尾辞 -builder) ビルドの 2 つのビルドが生成され、Web コンソールの Builds ページに一覧表示されます。S2I メカニズムは OpenShift ビルドでアプリケーションを構築し、このアプリケーションを次の OpenShift ビルドに渡してランタイムコンテナーイメージにパッケージ化します。Red Hat build of Kogito S2I ビルド設定では、OpenShift プラットフォームの Git リポジトリーから直接プロジェクトをビルドできます。

9. アプリケーションのビルドが完了したら、Workloads → Deployments に移動して、アプリケーションのデプロイメント、Pod のステータスなどの情報を表示します。

10. Red Hat build of Kogito マイクロサービスをデプロイしたら、Web コンソールの左側のメニューの Networking → Routes に移動し、デプロイされたアプリケーションへのアクセスリンクを表示します。

    アプリケーション名を選択して、ルート設定を表示または変更できます。

    必要に応じてアプリケーションルートを使用すると、Red Hat build of Kogito マイクロサービスはビジネス自動化ソリューションと統合できます。

手順

1. アプリケーションをローカルに構築します。
2. Operators → Installed Operators に移動し、RHPAM Kogito Operator を選択します。
3. Red Hat build of Kogito ビルド定義を作成するには、Operator ページで Kogito Build タブを選択し、Create KogitoBuild をクリックします。

4. アプリケーションウィンドウで、Form View または YAML View を使用してビルド定義を設定します。

   少なくとも、以下の YAML ファイルのサンプルに示されるようにアプリケーション設定を定義します。

   Red Hat build of Kogito ビルドを使用した Red Hat build of Quarkus アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-quarkus  # Application name
   spec:
     type: Binary

   Copy to Clipboard Toggle word wrap

   Red Hat build of Kogito ビルドを使用した Spring Boot アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot
     type: Binary

   Copy to Clipboard Toggle word wrap

5. アプリケーションデータを定義したら、Create をクリックして Red Hat build of Kogito ビルドを生成します。

   アプリケーションが Red Hat build of KogitoBuilds ページに一覧表示されます。アプリケーション名を選択して、アプリケーション設定および YAML の詳細を表示または変更できます。

6. 以下のコマンドを使用して、ビルドしたバイナリーをアップロードします。

   $ oc start-build example-quarkus --from-dir=target/ -n namespace

   Copy to Clipboard Toggle word wrap
   • from-dir は、ビルドしたアプリケーションの target フォルダーパスと同じです。
   • namespace は、KogitoBuild の作成先の namespace に置き換えます。
7. Red Hat build of Kogito マイクロサービス定義を作成するには、Operator ページで Kogito Runtime タブを選択し、Create KogitoRuntime をクリックします。

8. アプリケーションウィンドウで、Form View または YAML View を使用してマイクロサービス定義を設定します。

   少なくとも、以下の YAML ファイルのサンプルに示されるようにアプリケーション設定を定義します。

   Red Hat build of Kogito マイクロサービスを使用した Red Hat build of Quarkus アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-quarkus  # Application name

   Copy to Clipboard Toggle word wrap

   Red Hat build of Kogito マイクロサービスを使用した Spring Boot アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot

   Copy to Clipboard Toggle word wrap

   注記

   この場合、アプリケーションは、KogitoRuntime を使用してローカルにビルドされ、デプロイされます。アプリケーション名が KogitoBuild および KogitoRuntime で同じである必要があります。

9. アプリケーションデータを定義したら、Create をクリックして Red Hat build of Kogito マイクロサービスを生成します。

   アプリケーションが Red Hat build of Kogito マイクロサービスページに一覧表示されます。アプリケーション名を選択して、アプリケーション設定や YAML ファイルの内容を表示または変更できます。

10. Web コンソールの左側のメニューで Builds → Builds に移動して、アプリケーションのビルドのステータスを表示します。

    特定のビルドを選択して、ビルドの詳細を表示できます。

11. アプリケーションのビルドが完了したら、Workloads → Deployments に移動して、アプリケーションのデプロイメント、Pod のステータスなどの情報を表示します。

12. Red Hat build of Kogito マイクロサービスをデプロイしたら、Web コンソールの左側のメニューの Networking → Routes に移動し、デプロイされたアプリケーションへのアクセスリンクを表示します。

    アプリケーション名を選択して、ルート設定を表示または変更できます。

    必要に応じてアプリケーションルートを使用すると、Red Hat build of Kogito マイクロサービスはビジネス自動化ソリューションと統合できます。

手順

1. アプリケーションをローカルに構築します。

2. 以下の内容を含むプロジェクトルートディレクトリーに Containerfile を作成します。

   Red Hat build of Quarkus アプリケーションの Containerfile の例

   FROM registry.redhat.io/rhpam-7/rhpam-kogito-runtime-jvm-rhel8:7.13.5
   
   ENV RUNTIME_TYPE quarkus
   
   COPY target/quarkus-app/lib/ $KOGITO_HOME/bin/lib/
   COPY target/quarkus-app/*.jar $KOGITO_HOME/bin
   COPY target/quarkus-app/app/ $KOGITO_HOME/bin/app/
   COPY target/quarkus-app/quarkus/ $KOGITO_HOME/bin/quarkus/

   Copy to Clipboard Toggle word wrap

   Spring Boot アプリケーションの Containerfile の例

   FROM registry.redhat.io/rhpam-7/rhpam-kogito-runtime-jvm-rhel8:7.13.5
   
   ENV RUNTIME_TYPE springboot
   
   COPY target/<application-jar-file> $KOGITO_HOME/bin

   Copy to Clipboard Toggle word wrap

   • application-jar-file は、アプリケーションの JAR ファイルの名前です。

3. 以下のコマンドを使用して Red Hat build of Kogito イメージをビルドします。

   podman build --tag <final-image-name> -f <Container-file>

   Copy to Clipboard Toggle word wrap

   このコマンドでは、final-image-name は Red Hat build of Kogito イメージの名前、Container-file は直前の手順で作成した Containerfile に置き換えます。

4. 必要に応じて、以下のコマンドを使用してビルドイメージをテストします。

   podman run --rm -it -p 8080:8080 <final-image-name>

   Copy to Clipboard Toggle word wrap

5. 以下のコマンドを使用して、ビルドした Red Hat build of Kogito イメージをイメージレジストリーにプッシュします。

   podman push <final-image-name>

   Copy to Clipboard Toggle word wrap
6. Operators → Installed Operators に移動し、RHPAM Kogito Operator を選択します。
7. Red Hat build of Kogito マイクロサービス定義を作成するには、Operator ページで Kogito Runtime タブを選択し、Create KogitoRuntime をクリックします。

8. アプリケーションウィンドウで、Form View または YAML View を使用してマイクロサービス定義を設定します。

   少なくとも、以下の YAML ファイルのサンプルに示されるようにアプリケーション設定を定義します。

   Red Hat build of Kogito マイクロサービスを使用した Red Hat build of Quarkus アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime # Application type
   metadata:
     name: example-quarkus # Application name
   spec:
     image: <final-image-name> # Kogito image name
     insecureImageRegistry: true # Can be omitted when image is pushed into secured registry with valid certificate

   Copy to Clipboard Toggle word wrap

   Red Hat build of Kogito マイクロサービスを使用した Spring Boot アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime # Application type
   metadata:
     name: example-springboot # Application name
   spec:
     image: <final-image-name> # Kogito image name
     insecureImageRegistry: true # Can be omitted when image is pushed into secured registry with valid certificate
     runtime: springboot

   Copy to Clipboard Toggle word wrap

9. アプリケーションデータを定義したら、Create をクリックして Red Hat build of Kogito マイクロサービスを生成します。

   アプリケーションが Red Hat build of Kogito マイクロサービスページに一覧表示されます。アプリケーション名を選択して、アプリケーション設定や YAML ファイルの内容を表示または変更できます。

10. アプリケーションのビルドが完了したら、Workloads → Deployments に移動して、アプリケーションのデプロイメント、Pod のステータスなどの情報を表示します。

11. Red Hat build of Kogito マイクロサービスをデプロイしたら、Web コンソールの左側のメニューの Networking → Routes に移動し、デプロイされたアプリケーションへのアクセスリンクを表示します。

    アプリケーション名を選択して、ルート設定を表示または変更できます。

    必要に応じてアプリケーションルートを使用すると、Red Hat build of Kogito マイクロサービスはビジネス自動化ソリューションと統合できます。

手順

1. Operators → Installed Operators に移動し、RHPAM Kogito Operator を選択します。
2. Red Hat build of Kogito ビルド定義を作成するには、Operator ページで Kogito Build タブを選択し、Create KogitoBuild をクリックします。

3. アプリケーションウィンドウで、Form View または YAML View を使用してビルド定義を設定します。

   少なくとも、以下の YAML ファイルのサンプルに示されるようにアプリケーション設定を定義します。

   Red Hat build of Kogito ビルドを使用した Red Hat build of Quarkus アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-quarkus  # Application name
   spec:
     type: LocalSource

   Copy to Clipboard Toggle word wrap

   Red Hat build of Kogito ビルドを使用した Spring Boot アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot
     type: LocalSource

   Copy to Clipboard Toggle word wrap

   注記

   内部 Maven リポジトリーを設定した場合は、Maven ミラーサービスとして使用でき、Red Hat build of Kogito ビルド定義に Maven ミラー URL を指定して、ビルド時間を大幅に短縮できます。

   spec:
     mavenMirrorURL: http://nexus3-nexus.apps-crc.testing/repository/maven-public/

   Copy to Clipboard Toggle word wrap

   内部 Maven リポジトリーの詳細は、Apache Maven ドキュメントを参照してください。

4. アプリケーションデータを定義したら、Create をクリックして Red Hat build of Kogito ビルドを生成します。

   アプリケーションが Red Hat build of KogitoBuilds ページに一覧表示されます。アプリケーション名を選択して、アプリケーション設定および YAML の詳細を表示または変更できます。

5. 以下のコマンドを使用して、ファイルアセットをアップロードします。

   $ oc start-build example-quarkus-builder --from-file=<file-asset-path> -n namespace

   Copy to Clipboard Toggle word wrap
   • file-asset-path は、アップロードするファイルハンドラーのパスに置き換えます。
   • namespace は、KogitoBuild の作成先の namespace に置き換えます。
6. Red Hat build of Kogito マイクロサービス定義を作成するには、Operator ページで Kogito Runtime タブを選択し、Create KogitoRuntime をクリックします。

7. アプリケーションウィンドウで、Form View または YAML View を使用してマイクロサービス定義を設定します。

   少なくとも、以下の YAML ファイルのサンプルに示されるようにアプリケーション設定を定義します。

   Red Hat build of Kogito マイクロサービスを使用した Red Hat build of Quarkus アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-quarkus  # Application name

   Copy to Clipboard Toggle word wrap

   Red Hat build of Kogito マイクロサービスを使用した Spring Boot アプリケーションの YAML 定義の例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot

   Copy to Clipboard Toggle word wrap

   注記

   この場合、アプリケーションはファイルからビルドされ、KogitoRuntime を使用してデプロイされます。アプリケーション名が KogitoBuild および KogitoRuntime で同じである必要があります。

8. アプリケーションデータを定義したら、Create をクリックして Red Hat build of Kogito マイクロサービスを生成します。

   アプリケーションが Red Hat build of Kogito マイクロサービスページに一覧表示されます。アプリケーション名を選択して、アプリケーション設定や YAML ファイルの内容を表示または変更できます。

9. Web コンソールの左側のメニューで Builds → Builds に移動して、アプリケーションのビルドのステータスを表示します。

   特定のビルドを選択して、ビルドの詳細を表示できます。

   注記

   OpenShift デプロイメント用に作成するすべての Red Hat build of Kogito マイクロサービスでは、従来のランタイムビルドと S2I (接尾辞 -builder) ビルドの 2 つのビルドが生成され、Web コンソールの Builds ページに一覧表示されます。S2I メカニズムは OpenShift ビルドでアプリケーションを構築し、このアプリケーションを次の OpenShift ビルドに渡してランタイムコンテナーイメージにパッケージ化します。

10. アプリケーションのビルドが完了したら、Workloads → Deployments に移動して、アプリケーションのデプロイメント、Pod のステータスなどの情報を表示します。

11. Red Hat build of Kogito マイクロサービスをデプロイしたら、Web コンソールの左側のメニューの Networking → Routes に移動し、デプロイされたアプリケーションへのアクセスリンクを表示します。

    アプリケーション名を選択して、ルート設定を表示または変更できます。

    必要に応じてアプリケーションルートを使用すると、Red Hat build of Kogito マイクロサービスはビジネス自動化ソリューションと統合できます。

手順

1. 以下の例のように、プロジェクトの KogitoRuntime YAML ファイルでプローブを定義します。

1. KIE Server を使用して、既存の外部アプリケーションを汎用 KIE Server API から特定の DMN REST エンドポイントに移行します。
2. KIE Server にデプロイされた KJAR を Red Hat build of Kogito マイクロサービスに移行します。
3. Red Hat OpenShift Container Platform を使用して Red Hat build of Kogito マイクロサービスをデプロイします。
4. 外部アプリケーションを再接続し、REST API の消費を特定の DMN REST エンドポイントから Red Hat build of Kogito デプロイメントに移行します。

手順

1. 外部アプリケーションで REST エンドポイントを使用している場合は、GET /server/containers/{containerId}/dmn/openapi.json(|.yaml) エンドポイントを使用して KJAR の Swagger または OAS 仕様ファイルを取得します。

   特定の DMN モデルの REST エンドポイントの詳細は、特定の DMN モデルの REST エンドポイント を参照してください。

2. 外部アプリケーションで、Java または JDK ライブラリーを選択して、デシジョンサービスと対話します。特定の KJAR の REST エンドポイントを使用してデシジョンサービスと対話できます。

手順

1. Red Hat build of Kogito マイクロサービス用の Maven プロジェクトを作成します。

   Maven プロジェクトの作成手順は、Red Hat build of Kogito マイクロサービスの Maven プロジェクトの作成 を参照してください。

   Maven プロジェクトは Kogito アーティファクトを作成します。

2. KJAR の src/main/resources フォルダーから Kogito アーティファクトの src/main/resources フォルダーに DMN モデルをコピーします。

3. テストシナリオを KJAR の src/test/resources フォルダーから Kogito アーティファクトの src/test/resources フォルダーにコピーします。

   重要

   プロジェクトの pom.xml ファイルに、テストシナリオの Red Hat build of Kogito 依存関係をインポートし、KIE Server REST API を使用して JUnit アクティケーターを作成する必要があります。詳細は、テストシナリオを使用したデシジョンサービスのテスト を参照してください。

4. 以下のコマンドを実行して、指定した回帰テストに対してテストシナリオが実行されていることを確認します。

   mvn clean install

   Copy to Clipboard Toggle word wrap

   Red Hat build of Kogito アプリケーションの実行後に、Swagger または OAS 仕様ファイルを取得できます。Swagger または OAS 仕様は、以下の実装の詳細とともに REST エンドポイントと同じ情報を提供します。

   • API が利用できるサーバーのベース URL
   • スキーマ名の参照

   外部アプリケーションを新しい URL に再ルーティングする場合には、指定の実装の詳細を使用できます。

1. KIE Server にデプロイされた KJAR を Red Hat build of Kogito マイクロサービスに移行します。
2. Red Hat OpenShift Container Platform を使用して Red Hat build of Kogito マイクロサービスをデプロイします。
3. KIE Server 上のクライアント PMML API から Red Hat build of Kogito デプロイメントの REST API に外部アプリケーションを変更します。

手順

1. Red Hat build of Kogito マイクロサービス用の Maven プロジェクトを作成します。

   Maven プロジェクトの作成手順は、Red Hat build of Kogito マイクロサービスの Maven プロジェクトの作成 を参照してください。

   Maven プロジェクトは Kogito アーティファクトを作成します。

2. KJAR の src/main/resources フォルダーから Kogito アーティファクトの src/main/resources フォルダーに PMML モデルをコピーします。

3. 以下のコマンドを実行して、Red Hat build of Kogito アプリケーションを実行します。

   mvn clean install

   Copy to Clipboard Toggle word wrap

   Red Hat build of Kogito アプリケーションの実行後に、Swagger または OAS 仕様ファイルを取得できます。Swagger または OAS 仕様は、以下の実装の詳細とともに REST エンドポイントと同じ情報を提供します。

   • API が利用できるサーバーのベース URL
   • スキーマ名の参照

   外部アプリケーションを新しい URL に再ルーティングする場合には、指定の実装の詳細を使用できます。

手順

1. KIE Server クライアント API の使用状況をすべて削除し、HTTP 通信に置き換えます。以下は、Java 以外の要求の例です。

   

   View larger image

   

2. 同様の呼び出しを作成し、結果を解析するために、HTTP クライアントの Java ライブラリーが外部アプリケーション内で使用されるようにしてください。

   以下は、入力データを JSON に変換する Java 11 HTTP クライアントおよび Gson の例です。

   

   View larger image

   
   注記

   パラメーターの値として必要なすべてのパラメーターは、呼び出される URL に組み込まれます。