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