Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

Red Hat Decision Manager と Red Hat Fuse の統合

Red Hat Decision Manager 7.8

ガイド

概要

本書では、Apache Karaf および Red Hat JBoss Enterprise Application Platform で、Red Hat Fuse を Red Hat Decision Manager 7.8 と統合する方法を説明します。

はじめに
リンクのコピー

システム管理者は、Apache Karaf および Red Hat JBoss Enterprise Application Platform で、Red Hat Decision Manager と Red Hat Fuse を統合して、統合サービス間の通信を容易化します。

注記

Red Hat Decision Manager は、Spring Boot 上の Red Hat Fuse との統合をサポートしません。

第1章 Red Hat Fuse および Red Hat Decision Manager
リンクのコピー

Red Hat Fuse は、アジャイル統合ソリューションの一部である、分散型のクラウドネイティブ統合プラットフォームです。チームはこの分散アプローチを使用することで、必要に応じて統合サービスをデプロイできます。Fuse には、統合エキスパート、アプリケーション開発者、ビジネスユーザーなど、さまざまなユーザーに柔軟にサービスを提供でき、各自がデプロイメント、アーキテクチャー、ツールを選択できます。API 中心のコンテナーベースのアーキテクチャーは、各サービスを切り離して、個別に作成、展開、デプロイできるようにします。その結果、企業全体のコラボレーションをサポートする統合ソリューションが実現できます。

Red Hat Decision Manager は、ビジネスルール管理、複合イベント処理、Decision Model & Notation (DMN) 実行、およびプランニングの問題を解決するための Red Hat Business Optimizer を組み合わせた、オープンソースの意思決定管理プラットフォームです。これにより、ビジネス上の意思決定を自動化し、そのロジックをビジネス全体で利用できるようにします。

ルール、デシジョンテーブル、DMN モデルなどのビジネスアセットはプロジェクト内で組織化され、Business Central リポジトリーに保存されます。これにより、ビジネス全体で一貫性や透明性を維持し、監査を行えます。ビジネスユーザーは、IT 担当者からのサポートなしでビジネスロジックを編集できます。

Apache Karaf コンテナープラットフォームまたは Red Hat JBoss Enterprise Application Platform に Red Hat Fuse をインストールしてから、このコンテナーに Red Hat Decision Manager をインストールし、設定してください。

重要

Red Hat Decision Manager 7.8 がサポートする Red Hat Fuse のバージョンについては、Red Hat Process Automation Manager 7 でサポートされる設定 を参照してください。

1.1. Red Hat Decision Manager の Karaf 機能
リンクのコピー

以下の表では、Red Hat Decision Manager の Karaf 機能を紹介します。

Expand
機能説明

drools-module

Drools のコアとコンパイラーが含まれており、プレーン DRL から KIE ベースと KIE セッションを作成するのに使用します。また、実行可能モデルの実装も含まれています。永続性、プロセス、またはデシジョンテーブルを必要とせずに Drools を使用してルール評価ができます。

drools-template

Drools テンプレートが含まれています。

drools-jpa

プロセスまたはデシジョンテーブルを必要とせずに、Drools を使用して永続性 (Persistence) とトランザクション (Transaction) でルール評価を行います。drools-jpa 機能には drools-module が含まれますが、droolsjbpm-hibernate 機能をインストールするか、互換性のあるハイバネートバンドルがインストールされているようにしてください。

drools-decisiontable

デシジョンテーブルと合わせて、Drools を使用します。

コアエンジン JAR および kie-ci

Red Hat Decision Manager と KIE スキャナー (kie-ci) を使用して、Maven リポジトリーから kJAR をダウンロードします。

kie-camel

Fuse と Red Hat Decision Manager を統合する Apache Camel エンドポイントである kie-camel コンポーネントを提供します。

kie-spring

kie-spring コンポーネントをインストールし、XML タグを使用して KIE セッションのリスナーを設定可能にします。

Apache Karaf は、スタンドアロンで、オープンソースのランタイム環境です。OSGi Alliance の OSGi 標準に基づいています。Karaf は、高度なクラ出力ディングサポートを備えた OSGi バンドルを通じてモジュール化のサポートを提供します。Karaf コンテナーでは、依存関係の複数のバージョンを並行してデプロイできます。ホットコードスワップを使用すると、コンテナーをシャットダウンせずにモジュールをアップグレードまたは置き換えることができます。

Red Hat Decision Manager は、Karaf 機能を使用して、Karaf で FUSE と統合されます。これらの機能を使用して、Karaf 上の FUSE 向けに Red Hat Decision Manager の個別のコンポーネントをインストールできます。

機能ファイルは XML ファイルで、このファイルを使用して特定の機能向けにどの DOSGI バンドルをインストールするかを指定します。以下の機能 XML ファイルにより、Red Hat Decision Manager と Fuse on Karaf の統合を容易にします。

  • rhba-features-<FUSE-VERSION>-features.xml

    このファイルは、Karaf にインストールした Fuse に含まれており、<FUSE-VERSION> は Fuse のバージョンに置き換えます。このファイルは、system/org/jboss/fuse/features/rhba-features ディレクトリーの Karaf システムリポジトリーに保存されます。このファイルには、Red Hat Decision Manager 機能をインストールするための前提条件が含まれています。

  • kie-karaf-features-7.39.0.Final-redhat-00005-features-fuse.xml

    このファイルは Red Hat Decision Manager に含まれており、Red Hat Decision Manager 機能を提供します。この機能により、Red Hat Fuse にデプロイできる OSGi 機能が決まります。OSGi ユーザーは、このファイルから機能をインストールして、Red Hat Decision Manager を Fuse にインストールし、それぞれのアプリケーションで使用できます。この機能ファイルは、Red Hat Process Automation Manager で配布されるオンラインおよびオフラインの Maven リポジトリーに配置されています。この機能ファイルは、Red Hat Process Automation Manager で配布されるオンラインおよびオフラインの Maven リポジトリーに配置されています。このファイルのグループ ID、アーティファクト ID、およびバージョン (GAV) 識別子は、org.kie:kie-karaf-features:7.39.0.Final-redhat-00005 です。

2.1. Karaf 上の古くなった Red Hat Decision Manager 機能 XML ファイルの削除
リンクのコピー

お使いの環境に、以前の Red Hat Decision Manager 機能 XML ファイル (例: kie-karaf-features-<VERSION>-features.xml) が含まれている場合には、このファイルと関連するファイルすべてを削除してから、最新の機能 XML ファイルをインストールする必要があります。

前提条件

  • 以前の機能 XML ファイルが Apache Karaf の環境に存在する。

手順

  1. 以下のコマンドを実行して、使用環境に以前の Red Hat Decision Manager 機能 XML ファイルが含まれているかどうかを確認します。 

    $ JBossFuse:karaf@root> feature:repo-list
$ JBossFuse:karaf@root> feature:list
    Copy to Clipboard Toggle word wrap

  2. 以下のコマンドを入力します。<FUSE_HOME> は Fuse のインストールディレクトリーに置き換えて、Red Hat Fuse コンソールを起動します。 

    $ ./<FUSE_HOME>/bin/fuse
    Copy to Clipboard Toggle word wrap

  3. 以下のコマンドを入力します。<FEATURE_NAME> は、アンインストールする機能の名前に置き換えて、以前の機能 XML ファイルを使用するアプリケーションまたは機能をアンインストールします。 

    JBossFuse:karaf@root> features:uninstall <FEATURE_NAME>
    Copy to Clipboard Toggle word wrap

    以下の例では、機能の削除方法を紹介します。 

    JBossFuse:karaf@root> features:uninstall drools-module
JBossFuse:karaf@root> features:uninstall jbpm
JBossFuse:karaf@root> features:uninstall kie-ci
    Copy to Clipboard Toggle word wrap

  4. Karaf の home で、drools、kie、または jbpm を使用するバンドルへの参照を検索します。以下の例では、grep を使用してこれらのコンポーネントを検索する方法を示しています。 

    karaf@root> list -t 0 -s | grep drools
karaf@root> list -t 0 -s | grep kie
karaf@root> list -t 0 -s | grep jbpm
    Copy to Clipboard Toggle word wrap

    この例は、上記のコマンドからの出力です。 

    250 │ Active   │  80 │ 7.19.0.201902201522          │ org.drools.canonical-model
251 │ Active   │  80 │ 7.19.0.201902201522          │ org.drools.cdi
252 │ Active   │  80 │ 7.19.0.201902201522          │ org.drools.compiler
    Copy to Clipboard Toggle word wrap

  5. 以下のコマンドを入力します。BUNDLE_ID は、検索で返されたバンドル ID に置き換えて、以前の手順で検出されたバンドルを削除します。 

    karaf@root> osgi:uninstall BUNDLE_ID
    Copy to Clipboard Toggle word wrap

  6. 次のコマンドを入力して、古くなった drools-karaf-features の URL を削除します。 

    karaf@root> features:removeurl
 mvn:org.kie/kie-karaf-features/VERSION.Final-redhat-VERSION/xml/features
    Copy to Clipboard Toggle word wrap
  7. Fuse を再起動します。

2.2. XML ファイルを使用した Karaf への Red Hat Decision Manager 機能のインストール
リンクのコピー

Karaf に Red Hat Decision Manager 機能をインストールして、Red Hat Decision Manager プロセス向けに動的ランタイム環境を作成します。

前提条件

手順

Red Hat Decision Manager の機能をインストールするには、次のコマンドを入力します。 

$ JBossFuse:karaf@root> feature:install <FEATURE_NAME>
Copy to Clipboard Toggle word wrap
注記

org.drools.osgi.spring.OsgiKModuleBeanFactoryPostProcessor の代わりに org.kie.spring.KModuleBeanFactoryPostProcessor を使用して、OSGi 環境の KIE 要素を後処理します。

kie-spring 機能をインストールする前に drools-module 機能をインストールしないようにしてください。先にインストールしてしまうと、drools-compiler バンドルにより、kie-spring がエクスポートしたパッケージが検出されなくなります。

これらの機能を間違った順番でインストールした場合は、osgi:refresh drools-compiler_bundle_ID を実行して、drools-compiler が強制的に Import-Package メタデータをリビルドするようにします。

このコマンドでは、<FEATURE_NAME> は、「Red Hat Decision Manager の Karaf 機能」 に記載の機能の 1 つに置き換えます。

2.3. Maven を使用した Karaf への Red Hat Decision Manager 機能のインストール
リンクのコピー

必要に応じて、Apache Karaf 上にある Fuse で Red Hat Decision Manager をインストールして、統合サービスをデプロイします。

前提条件

手順

  1. Maven リポジトリーを設定するには、テキストエディターで FUSE_HOME/etc/org.ops4j.pax.url.mvn.cfg ファイルを開きます。

  2. https://maven.repository.redhat.com/ga/ リポジトリーが org.ops4j.pax.url.mvn.repositories 変数に存在することを確認します。必要に応じて、追加してください。

    注記

    エントリーは、コンマ、スペース、およびバックスラッシュ (, \) で区切ります。バックスラッシュを追加すると、強制的に改行されます。

  3. Fuse を起動するには以下のコマンドを入力します。<FUSE_HOME> は Fuse のインストールディレクトリーに置き換えます。 

    $ ./FUSE_HOME/bin/fuse
    Copy to Clipboard Toggle word wrap

  4. インストールの前提条件が含まれる機能ファイルに参照を追加するには、以下のコマンドを入力します。<FUSE_VERSION は、インストールする Fuse のバージョンに置き換えます。 

    $ feature:repo-add mvn:org.jboss.fuse.features/rhba-features/<FUSE-VERSION>/xml/features
    Copy to Clipboard Toggle word wrap

  5. 以下のコマンドを入力して、Red Hat Decision Manager 機能の XML ファイルへの参照を追加します。 

    $ JBossFuse:karaf@root> features:addurl mvn:org.kie/kie-karaf-features/VERSION/xml/features-fuse
    Copy to Clipboard Toggle word wrap

    現在の drools-karaf-features バージョンをチェックするには、Red Hat Process Automation Manager 7 Supported Configurations ページを参照してください。

  6. 以下のコマンドを入力して、Red Hat Decision Manager 機能の XML ファイルで提供される機能をインストールします。このコマンドでは、<FEATURE_NAME> は、「Red Hat Decision Manager の Karaf 機能」 に記載の機能の 1 つに置き換えます。 

    JBossFuse:karaf@root> features:install <FEATURE_NAME>
    Copy to Clipboard Toggle word wrap

  7. 次のコマンドを入力して、インストールを確認します。 

    $ JBossFuse:karaf@root>feature:list
    Copy to Clipboard Toggle word wrap

    機能が正常にインストールされると、ステータスは started になります。

第3章 Red Hat JBoss Enterprise Application Platform へ の Fuse のインストール
リンクのコピー

Red Hat Decision Manager で使用できるように Red Hat JBoss EAP 7.2.3 に Red Hat Fuse 7.6 をインストールし、必要に応じて統合サービスをデプロイします。

注記

Red Hat Fuse 7.6 は Red Hat JBoss EAP 7.2.3 でサポートされていますが、Red Hat Decision Manager は Red Hat JBoss EAP 7.3 でサポートされています。デプロイメント環境の安定性を確保するには、サポートされている Red Hat JBoss EAP バージョンに基づいて、Fuse および Red Hat Decision Manager を別の Red Hat JBoss EAP インスタンスにインストールしてください。

前提条件

手順

  1. Red Hat JBoss Enterprise Application Platform 7.2.3 に Red Hat Fuse 7.6 をインストールします。インストールの説明は、Install Fuse 7.6 on JBoss EAP 7.2 を参照してください。
  2. テキストエディターで、Fuse のホームディレクトリーにある pom.xml を開きます。

  3. 以下の例のように pom.xml ファイルを編集して、kie-camel コンポーネントの依存関係を含めて、統合プロジェクトを作成します。 

    <dependency>
  	<groupId>org.apache.camel</groupId>
  	<artifactId>camel-core</artifactId>
  	<scope>provided</scope>
</dependency>
<dependency>
  	<groupId>org.kie</groupId>
  	<artifactId>kie-api</artifactId>
</dependency>
<dependency>
  	<groupId>org.kie</groupId>
  	<artifactId>kie-ci</artifactId>
  	<exclusions>
    	<exclusion>
      	<groupId>aopalliance</groupId>
      	<artifactId>aopalliance</artifactId>
    	</exclusion>
  	</exclusions>
</dependency>
<dependency>
  	<groupId>org.kie.server</groupId>
  	<artifactId>kie-server-api</artifactId>
  	<exclusions>
    	<exclusion>
      	<groupId>org.jboss.spec.javax.xml.bind</groupId>
      	<artifactId>jboss-jaxb-api_2.3_spec</artifactId>
    	</exclusion>
    	<exclusion>
      	<groupId>javax.activation</groupId>
      	<artifactId>activation</artifactId>
    	</exclusion>
  	</exclusions>
</dependency>
<dependency>
  	<groupId>org.jbpm</groupId>
  	<artifactId>jbpm-bpmn2</artifactId>
	</dependency>
	<dependency>
  	<groupId>org.kie</groupId>
  	<artifactId>kie-camel</artifactId>
  	<exclusions>
    	<exclusion>
      	<groupId>org.apache.cxf</groupId>
      	<artifactId>cxf-core</artifactId>
    	</exclusion>
    	<exclusion>
      	<groupId>org.apache.camel</groupId>
      	<artifactId>camel-cxf</artifactId>
    	</exclusion>
    	<exclusion>
      	<groupId>org.apache.camel</groupId>
      	<artifactId>camel-cxf-transport</artifactId>
    	</exclusion>
    	<exclusion>
      	<groupId>com.thoughtworks.xstream</groupId>
      	<artifactId>xstream</artifactId>
    	</exclusion>
  	</exclusions>
</dependency>
<dependency>
   	<groupId>org.kie.server</groupId>
   	<artifactId>kie-server-client</artifactId>
   	<exclusions>
     	<exclusion>
       	<groupId>org.jboss.spec.javax.ws.rs</groupId>
       	<artifactId>jboss-jaxrs-api_2.0_spec</artifactId>
     	</exclusion>
   	</exclusions>
</dependency>
    Copy to Clipboard Toggle word wrap

第4章 kie-camel コンポーネント
リンクのコピー

kie-camel コンポーネントは、Fuse と Red Hat Decision Manager が統合された Red Hat Fuse が提供する Apache Camel エンドポイントです。このコンポーネントを使用して、ルートにするプルして実行できる Maven グループ ID、アーティファクト ID、バージョン (GAV) の識別子を使用して、Red Hat Decision Manager モジュールを指定できます。また、ファクトとしてメッセージボディーの一部を指定できます。埋め込みエンジンや KIE Server で、kie-camel コンポーネントを使用できます。

埋め込みエンジン

このシナリオでは、KIE エンジンが Fuse 統合プロジェクトと同じコンテナーで実行されます。エンジン間の通信には、KIE コマンドを使用できます。Camel プロデューサーを作成するには、以下の URI を使用します。 

kie-local:kie-session-name?action=execute
Copy to Clipboard Toggle word wrap

たとえば、次のコマンドを入力して、Spring の Camel ルートを初期化します。 

<from uri="direct:runCommand" />
  	<to uri="kie-local:kie-session1?action=execute"/>
Copy to Clipboard Toggle word wrap

KIE Server

このシナリオでは、kie-camel コンポーネントは KIE Server REST API を使用して KIE Server に接続します。こうすることでユーザーは、KIE Server API を使用して KIE Server と通信できます。プロデューサーを作成するには、以下の URI を使用します。 

kie:http://username:password@kie-server-url`
Copy to Clipboard Toggle word wrap

たとえば、次のコマンドを入力して、Spring の Camel ルートを初期化します。 

<from uri="direct:runCommand" />
  	<to uri="kie:http://user:psswd@localhost:8080/kie-server-services/services/rest/server"/>
Copy to Clipboard Toggle word wrap

メッセージには以下のヘッダーが含まれます。

Expand
表4.1 メッセージのヘッダーと説明
ヘッダー説明

CamelKieClient

KIE Server クライアント (必須)

CamelKieOperation

KIE Server クライアント (必須)

CamelKieParameterName

クライアントメソッドパラメーターの値 (任意)

CamelKieBodyParam

メッセージボディーを保存するメソッドパラメーター (任意)

付録A バージョン情報
リンクのコピー

本書の最終更新日: 2022 年 3 月 8 日 (火)

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る