第2章 Decision Central でのプロジェクトデプロイメント
Decision Central を使用してビジネスアセットおよびサービスを開発し、プロジェクトデプロイメントに設定した Decision Server を管理できます。プロジェクトを開発する際に、Decision Central にプロジェクトをビルドして、Decision Server に自動的にデプロイできます。自動デプロイメントを有効にするために、Decision Central には Maven リポジトリーが組み込まれています。Decision Central から、ビルドしてデプロイしておいたサービスおよびプロジェクトバージョンを含むデプロイメントユニット (KIE コンテナー) を起動、停止、または削除できます。
(Menu
たとえば、Test 設定のテストサーバーと、Production 設定の実稼働サーバーを使用できます。ビジネスアセットとサービスをプロジェクトに開発し、Test サーバー設定にプロジェクトをデプロイしてから、十分にテストしたプロジェクトのバージョンを Production サーバー設定にデプロイできます。このとき、プロジェクトの開発を継続するには、プロジェクト設定でバージョンを変更します。これにより、組み込み Maven リポジトリーで、新しいバージョンと古いバージョンが別のアーティファクトと見なされるため、Test サーバー設定に新しいバージョンをデプロイし、Production サーバー設定で古いバージョンを実行し続けることができます。このデプロイメントプロセスは単純ですが、重要な制約があります。とりわけ、アクセス制御は十分ではなく、プロジェクトを実稼働環境に直接デプロイできてしまいます。
Decision Central を使用して、で聖ジョンサーバーを別のサーバー設定に移動することはできません。サーバーの設定名を変更するには、サーバーの設定ファイルを変更する必要があります。
2.1. Decision Central に接続するように Decision Server の設定 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Decision Manager 環境で Decision Serverがすでに設定されていない場合や、Red Hat Decision Manager 環境に追加の Decision Server が必要な場合には、Decision Server が Decision Central に接続するように設定する必要があります。
Red Hat OpenShift Container Platform に Decision Server をデプロイする場合は、『Red Hat OpenShift Container Platform への Red Hat Decision Manager 管理サーバー環境のデプロイメント』で、Business Central に接続する設定手順を参照してください。
前提条件
Decision Central および Decision Server がインストールされている。詳細は、RED HAT DECISION MANAGER インストールのプラニング を参照してください。
手順
-
Red Hat Decision Manager インストールディレクトリーで、
standalone-full.xmlファイルに移動します。たとえば、Red Hat Decision Manager に Red Hat JBoss EAP インストールを使用する場合は$EAP_HOME/standalone/configuration/standalone-full.xmlに移動します。 standalone-full.xmlを開き、<system-properties>タグの下に、以下のプロパティーを設定します。- org.kie.server.controller.user: Decision Central にログインするユーザーのユーザー名。
- org.kie.server.controller.pwd: Decision Central にログインするユーザーのパスワード。
-
org.kie.server.controller: Decision Central の API に接続する URL。通常は
http://<centralhost>:<centralport>/decision-central/rest/controller(<centralhost>および<centralport>はそれぞれ Decision Central のホスト名およびポート) になります。Decision Central を OpenShift にデプロイしている場合は、URL からdecision-central/を削除します。 -
org.kie.server.location: Decision Server の API に接続する URL。通常、URL は
http://<serverhost>:<serverport>/kie-server/services/rest/server(<serverhost>および<serverport>はそれぞれ Decision Server のホスト名およびポート) になります。 - org.kie.server.id: サーバー設定の名前。このサーバー設定が Decision Central に存在しない場合は、Decision Server が Decision Central に接続する時に自動的に作成されます。
例:
<property name="org.kie.server.controller.user" value="central_user"/> <property name="org.kie.server.controller.password" value="central_password"/> <property name="org.kie.server.controller" value="http://central.example.com:8080/decision-central/rest/controller"/> <property name="org.kie.server.location" value="http://kieserver.example.com:8080/kie-server/services/rest/server"/> <property name="org.kie.server.id" value="production-servers"/>
<property name="org.kie.server.controller.user" value="central_user"/> <property name="org.kie.server.controller.password" value="central_password"/> <property name="org.kie.server.controller" value="http://central.example.com:8080/decision-central/rest/controller"/> <property name="org.kie.server.location" value="http://kieserver.example.com:8080/kie-server/services/rest/server"/> <property name="org.kie.server.id" value="production-servers"/>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Decision Server を起動または再起動します。
2.2. Decision Central および Decision Server への外部 Maven リポジトリーの設定 リンクのコピーリンクがクリップボードにコピーされました!
組み込みリポジトリーの代わりに、Nexus などの外部 Maven リポジトリーを使用するように Decision Central および Decision Server を設定できます。この場合、Decision Central でプロジェクトをビルドする際に、ビルドしたプロジェクトの全 KJAR ファイルがこの外部リポジトリーにプッシュされます。統合プロセスを実装する場合に、必要に応じてリポジトリーからこのファイルを処理し、Decision Central または Decision Server REST API を使用して KJAR ファイルをデプロイできます。
前提条件
Decision Central および Decision Server がインストールされている。詳細は、RED HAT DECISION MANAGER インストールのプラニング を参照してください。
手順
-
外部リポジトリーの接続およびアクセスの詳細が含まれる Maven
settings.xmlファイルを作成します。settings.xmlファイルの詳細は Maven の 「Settings Reference」を参照してください。 -
既知の場所 (例:
/opt/custom-config/settings.xml) にファイルを保存します。 -
Red Hat Decision Manager インストールディレクトリーで、
standalone-full.xmlファイルに移動します。たとえば、Red Hat Decision Manager に Red Hat JBoss EAP インストールを使用する場合は$EAP_HOME/standalone/configuration/standalone-full.xmlに移動します。 standalone-full.xmlの<system-properties>タグで、kie.maven.settings.customプロパティーにsettings.xmlファイルのフルパス名を設定します。例:
<property name="kie.maven.settings.custom" value="/opt/custom-config/settings.xml"/>
<property name="kie.maven.settings.custom" value="/opt/custom-config/settings.xml"/>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Decision Central と Decision Server を起動または再起動します。
2.3. Decision Central へのプロジェクトのビルドおよびデプロイメント リンクのコピーリンクがクリップボードにコピーされました!
プロジェクトを作成したら、Decision Central でプロジェクトをビルドして、設定した Decision Server にデプロイできます。プロジェクトをビルドしてデプロイする際に、Decision Central のプロジェクトは、必要なすべてのコンポーネントとともに KJAR として自動的にパッケージ化されます。
手順
-
Decision Central で、Menu
Design Projects に移動して、プロジェクト名をクリックします。 右上にある Deploy をクリックして、プロジェクトをビルドしてデプロイします。
注記Decision Server にプロジェクトをデプロイせずにコンパイルするには、Build をクリックします。
Decision Central に Decision Server を 1 つだけ接続する場合、または接続したすべての Decision Server が同じサーバー設定にある場合は、デプロイメントユニット (KIE コンテナー) にあるプロジェクトのサービスが自動的に起動します。
複数のサーバー設定が利用できる場合は、サーバーとデプロイメントの詳細の入力を求めるデプロイメントダイアログが Decision Central に表示されます。
デプロイメントダイアログが表示されたら、以下の値を確認または設定します。
- Deployment Unit Id / Deployment Unit Alias: Decision Server でサービスを実行しているデプロイメントユニット (KIE コンテナー) の名前およびエイリアスを確認します。通常は、この設定を変更する必要はありません。
- Server Configuration: このプロジェクトをデプロイするサーバー設定を選択します。後で、プロジェクトを再ビルドしなくても、設定したその他のサーバーにデプロイできます。
- Start Deployment Unit?: このボックスを選択してデプロイメントユニット (KIE コンテナー) を起動するか、選択を解除して、サービスがサーバーにデプロイしても起動しないようにします。
2.4. Decision Central のデプロイメントユニット リンクのコピーリンクがクリップボードにコピーされました!
プロジェクトのサービスが、設定した Decision Server のインスタンス化された KIE コンテナー、または デプロイメントユニット を介してランタイム時に使用されます。Decision Central にプロジェクトをビルドおよびデプロイすると、設定されたサーバーにデプロイメントユニットが自動的に作成されます。必要に応じて、Decision Central にデプロイメントユニットを起動、停止、または削除できます。ビルドされているプロジェクトから追加デプロイメントユニットを作成したり、Decision Central に設定した既存または新しい Decision Server のデプロイメントユニットを起動したりすることもできます。
2.4.1. Decision Central でのデプロイメントユニットの作成 リンクのコピーリンクがクリップボードにコピーされました!
お使いの Red Hat Decision Manager にはすでにデプロイメントユニットが 1 つ以上あるはずですが、ない場合は、Decision Central にビルドされているプロジェクトからデプロイメントユニットを作成できます。
前提条件
新しいデプロイメントユニットを作成するプロジェクトが Decision Central にビルドされている。
手順
-
Decision Central で Menu
Deploy Execution servers に移動します。 - Server Configurations の下で既存の設定を選択するか、New Server Configuration をクリックして新しい設定を作成します。
- Deployment Units の下で Add Deployment Unit をクリックします。
- ウィンドウのテーブルで GAV を選択し、GAV の横にある Select を選択して、デプロイメントユニットのデータフィールドを追加します。
- Start Deployment Unit? ボックスを選択してサービスを直ちに起動するか、選択を解除して後で起動します。
Finish をクリックします。
サービスに新しいデプロイメントユニットが作成され、このサーバー設定で指定した Decision Server に置かれました。Start Deployment Unit? を選択した場合は、サービスが起動します。
2.4.2. Decision Central のデプロイメントユニットの起動、停止、および削除 リンクのコピーリンクがクリップボードにコピーされました!
デプロイメントユニットを起動したら、デプロイメントユニットのサービスが利用できるようになります。Decision Central に Decision Server を 1 つだけ接続する場合、または接続したすべての Decision Server が同じサーバー設定にある場合は、デプロイメントユニットでサービスが自動的に起動します。複数のサーバー設定が利用可能な場合は、デプロイメント時に、サーバーとデプロイメントの詳細を指定して、デプロイメントユニットを起動するように求められます。ただし、必要に応じていつでも手動で Decision Central でデプロイメントユニットを起動、停止、または削除して、デプロイしたサービスを管理できます。
手順
-
Decision Central で Menu
Deploy Execution servers に移動します。 - Server Configurations の下で、設定を選択します。
- Deployment Units の下で、デプロイメントユニットを選択します。
- 右上の Start、Stop、または Remove をクリックします。実行中のデプロイメントユニットを削除する場合は、停止してから削除します。
2.5. Decision Central プロジェクトの GAV 値の編集 リンクのコピーリンクがクリップボードにコピーされました!
GroupId、ArtifactId、および Version (GAV) 値は、Maven リポジトリーのプロジェクトを識別します。Decision Central と Decision Server が同じファイルシステムにあり、同じ Maven リポジトリーを使用する場合は、新しいバージョンのプロジェクトをビルドするたびに、リポジトリーでプロジェクトが自動的に更新されます。ただし、Decision Central と Decision Server が別のファイルシステムにあり、ローカルの Maven リポジトリーをそれぞれ使用している場合は、新しいバージョンのプロジェクトでプロジェクトの GAV 値 (通常はバージョン) を更新し、古いバージョンと新しいバージョンのプロジェクトが別のアーティファクトとして表示されるようにします。
開発目的の場合に限り、プロジェクトバージョンに SNAPSHOT 接尾辞を追加して、Maven ポリシーに従って新しいスナップショットの更新を取得できるようにすることもできます。実稼働環境に SNAPSHOT 接尾辞を使用しないでください。
プロジェクトの Settings 画面に GAV 値を設定できます。
手順
-
Decision Central で、Menu
Design Projects に移動して、プロジェクト名をクリックします。 - プロジェクトの Settings タブをクリックします。
必要に応じて、General Settings の Group ID フィールド、 Artifact IDフィールド、Version フィールドを修正します。プロジェクトをデプロイし、新しいバージョンを開発中の場合は、通常はバージョン番号を変更する必要があります。
注記開発目的の場合に限り、プロジェクトバージョンに
SNAPSHOT接尾辞を追加して、Maven ポリシーに従って新しいスナップショットの更新を取得できるようにすることもできます。実稼働環境にSNAPSHOT接尾辞を使用しないでください。- Save をクリックして終了します。
2.6. Decision Central における重複した GAV の検出 リンクのコピーリンクがクリップボードにコピーされました!
Decision Central のすべての Maven リポジトリーで、GroupId、ArtifactId、Version (GAV) の各値が重複しているかどうかが確認されます。GAV が重複していると、実行された操作が取り消されます。
重複した GAV の検出は、以下の操作を実行するたびに実行されます。
- プロジェクトのプロジェクト定義の保存。
-
pom.xmlファイルを保存します。 - プロジェクトのインストール、ビルドまたはデプロイ。
以下の Maven リポジトリーで重複の GAV が確認されます。
-
pom.xmlファイルの<repositories>and<distributionManagement>要素で指定されたリポジトリー。 -
Maven の
settings.xml設定ファイルに指定されたリポジトリー。
2.6.1. Decision Central における重複した GAV 検出設定の管理 リンクのコピーリンクがクリップボードにコピーされました!
admin ロールを持つ Decision Central ユーザーは、プロジェクトで GroupId 値、ArtifactId 値、Version 値 (GAV) が重複しているかどうかを確認するリポジトリーの一覧を修正できます。
手順
-
Decision Central で、Menu
Design Projects に移動して、プロジェクト名をクリックします。 - プロジェクトの Settings タブをクリックし、Validation をクリックしてリポジトリーの一覧を開きます。
一覧表示したリポジトリーオプションの中から選択するか選択を解除して、重複した GAV の検出を有効または無効にします。
今後、重複した GAV の報告は、検証を有効にしたリポジトリーに対してのみ行われます。
注記この機能を無効にするには、システムの起動時に Decision Central の
org.guvnor.project.gav.check.disabledシステムプロパティーをtrueに設定します。~/EAP_HOME/bin/standalone.sh -c standalone-full.xml -Dorg.guvnor.project.gav.check.disabled=true
$ ~/EAP_HOME/bin/standalone.sh -c standalone-full.xml -Dorg.guvnor.project.gav.check.disabled=trueCopy to Clipboard Copied! Toggle word wrap Toggle overflow