3.2.5. 環境のカスタム Process Server 設定の設定
Business Automation Operator のすべての環境タイプには、デフォルトで 1 つまたは複数の Process Server が含まれます。
オプションで、Process Server のカスタム設定を設定できます。この場合、デフォルトの Process Server は作成されず、設定する Process Server のみがデプロイされます。
前提条件
- 「環境の基本設定の設定」 の説明に従って、インストーラーウィザードで Business Automation Operator を使用して Red Hat Process Automation Manager 環境の基本設定を行っていること。
- 認証に RH-SSO または LDAP を使用する必要がある場合は、「環境のセキュリティー設定の設定」 の説明に従ってセキュリティー設定を完了している。
手順
- Installation、Security、または Console タブが開いている場合は、KIE Servers タブが表示されるまで Next をクリックします。
- Add new KIE Server をクリックして、新規の Process Server 設定を追加します。
- Id フィールドに、Process Server の ID を入力します。Process Server が Business Central または Business Central Monitoring インスタンスに接続される場合、この ID はサーバーが加わるサーバーグループを決めるものとなります。
- Name フィールドで、Process Server の名前を入力します。
- Deployments フィールドで、デプロイする同様の Process Server の数を入力します。インストーラーは、同じ設定で複数の Process Server をデプロイできます。Process Server の ID および名前は自動的に変更され、一意な状態に保たれます。
- 「Process Server にシークレットの作成」 の説明に従って Process Server のシークレットを作成している場合、Secret フィールドにシークレットの名前を入力します。
- オプションで、Process Server のレプリカ数を Replicas フィールドに入力します。
Process Server のカスタムイメージを使用する必要がある場合には、以下の追加の手順を実行します。
- Set KIE Server image をクリックします。
- イメージストリームの名前を Name フィールドに入力します。
-
イメージストリームが
openshift名前空間にない場合は、名前空間を Namespace フィールドに入力します。
Source to Image(S2I)ビルドを使用してイミュータブル Process Server を設定する必要がある場合は、以下の追加の手順を実行します。
重要Maven リポジトリーからサービスをプルするイミュータブル Process Server を設定する必要がある場合は、Set Immutable server configuration をクリックせず、この手順を実行しないでください。代わりに、
KIE_SERVER_CONTAINER_REPLOYMENT環境変数を設定します。- Set Immutable server configuration をクリックします。
-
KIE Server コンテナーデプロイメント フィールドに、デプロイメントが Source to Image (S2I) ビルドの結果から展開する必要があるサービスの識別情報 (KJAR ファイル) を入力します。形式は
<containerId>=<groupId>:<artifactId>:<version>になります。また、コンテナーのエイリアス名で指定する場合には、形式は<containerId>(<aliasId>)=<groupId>:<artifactId>:<version>になります。以下の例に示されるように、区切り文字|を使用して 2 つ以上の KJAR ファイルを指定できます (例:containerId=groupId:artifactId:version|c2(alias2)=g2:a2:v2)。 - OpenShift 環境に公開インターネットへの接続がない場合は、「オフラインで使用する Maven ミラーリポジトリーの用意」 に従って、Maven mirror URL フィールドに設定した Maven ミラーの URL を入力します。
- Artifact directory フィールドで、Maven が正常にビルドされた後に、必要なバイナリーファイル (KJAR ファイルおよびその他の必要なファイル) が含まれるプロジェクト内のパスを入力します。通常、このディレクトリーはビルドのターゲットディレクトリーです。ただし、Git リポジトリーのこのディレクトリーにビルド済みのバイナリーを提供できます。
-
S2I ビルドにカスタムベース Process Server イメージを使用する必要がある場合は、Set Base build image をクリックします。イメージストリームが
openshift名前空間にない場合は、名前空間を Namespace フィールドに入力します。OpenShift イメージストリームタグではなく Docker イメージ名を使用する必要がある場合は、Kind の値をDockerImageに変更します。 Set Git source をクリックし、以下のフィールドに情報を入力します。
- S2I Git URI: サービスのソースが含まれる Git リポジトリーの URI。
- Reference: Git リポジトリーのブランチ。
- コンテキストディレクトリー: (オプション) Git リポジトリーからダウンロードされたプロジェクト内のソースへのパス。デフォルトで、ダウンロードされたプロジェクトのルートディレクトリーはソースディレクトリーです。
- Git Webhook を設定して Git リポジトリーで Process Server の自動リビルドをトリガーするように設定する必要がある場合は、Add new Webhook をクリックします。Type リストから Webhook のタイプを選択し、Secret フィールドに Webhook のシークレット文字列を入力します。
- 必要に応じて、Resource quotas 下のフィールドに必要な CPU およびメモリーの上限値を入力します。複数の Process Server を設定している場合は、制限値はそれぞれのサーバーに別々に適用されます。
RH-SSO 認証を選択している場合は、Process Server の RH-SSO を設定します。
- Client name フィールドにクライアント名を入力し、Client secret フィールドにクライアントシークレットを入力します。この名前を持つクライアントが存在しない場合は、デプロイメントでこの名前およびシークレットを持つ新規クライアントの作成を試行します。
- デプロイメントで新規クライアントを作成する場合、Process Server へのアクセスに使用する HTTP および HTTPS URL を SSO HTTP URL および SSO HTTPS URL フィールドに入力します。この情報は、クライアントに記録されます。
Process Server が使用する必要のあるデータベースを選択します。以下の値を使用できます。
-
mysql: 個別の Pod に作成される MySQL サーバー。 -
postgresql: 個別の Pod に作成される PostgreSQL サーバー。他の設定を使用する特別な理由のない限り、この設定を使用します。 -
h2: 個別の Pod を必要としないビルトインされたh2データベースエンジン。この設定を使用する場合には、Process Server Pod を収集しないでください。 external: 外部データベースサーバー。注記Red Hat Process Automation Manager 7.4 では、Business Automation Operator を使用して環境をデプロイする場合、MySQL および PostgreSQL 外部データベースサーバーのみがサポートされます。
-
- オプションで、Size フィールドに、データベースサーバー用に作成する永続ボリュームのサイズを入力します。
外部データベースサーバーを選択している場合は、追加のフィールドに以下の情報を入力します。
Driver: サーバーの種類に応じてデータベースサーバードライバーを入力します。
-
mysql -
postgresql -
mariadb -
mssql -
db2 -
oracle -
sybase
-
Dialect: サーバーの種類に応じて、サーバーの Hibernate ダイアレクトを入力します。
-
org.hibernate.dialect.MySQL5InnoDBDialect(MySQL および MariaDB で使用される) -
org.hibernate.dialect.PostgreSQL82Dialect -
org.hibernate.dialect.SQLServer2012Dialect(MS SQL で使用される) -
org.hibernate.dialect.DB2Dialect -
org.hibernate.dialect.Oracle10gDialect -
org.hibernate.dialect.SybaseASE157Dialect
-
- Host: 外部データベースサーバーのホスト名を入力します。
- Port: 外部データベースサーバーのポート番号を入力します。
- Jdbc URL: 外部データベースサーバーの JDBC URL を入力します。
- NonXA: データソースを XA 以外のモードで設定する必要がある場合にこのボックスを選択します。
- JNDI name: アプリケーションがデータソースに使用する JNDI 名を入力します。
- User name および Password: 外部データベースサーバーのユーザー名およびパスワードを入力します。
- Background validation: オプションとして、このボックスを選択してバックグラウンド SQL 検証を有効にし、バックグラウンド検証の間隔を入力します。
- 必要に応じて、最小および最大の接続プールサイズ、有効な接続チェッカークラス、およびデータベースサーバーの例外ソータークラスを設定します。
必要に応じて、環境変数を随時設定します。環境変数を設定するには、Add new Environment variable をクリックしてから、変数の名前および値を Name フィールドおよび Value フィールドに入力します。
設定した Maven リポジトリーからサービスをプルするイミュータブル KIE Server を設定する必要がある場合は、以下の設定を入力します。
-
KIE_SERVER_CONTAINER_DEPLOYMENT環境変数を設定します。変数には、デプロイメントが Maven リポジトリーからプルする必要のあるサービス (KJAR ファイル) の ID 情報が含まれている必要があります。形式は<containerId>=<groupId>:<artifactId>:<version>になります。また、コンテナーのエイリアス名で指定する場合には、形式は<containerId>(<aliasId>)=<groupId>:<artifactId>:<version>になります。以下の例に示されるように、区切り文字|を使用して 2 つ以上の KJAR ファイルを指定できます (例:containerId=groupId:artifactId:version|c2(alias2)=g2:a2:v2)。 - 外部 Maven リポジトリーの設定
-
外部 Maven リポジトリーを設定する必要がある場合には、以下の変数を設定します。
-
MAVEN_REPO_URL: Maven リポジトリーの URL -
MAVEN_REPO_ID: Maven リポジトリーの ID (例:repo-custom) -
MAVEN_REPO_USERNAME: Maven リポジトリーのユーザー名 -
MAVEN_REPO_PASSWORD: Maven リポジトリーのパスワード
-
OpenShift 環境に公開インターネットに接続されていない場合は、「オフラインで使用する Maven ミラーリポジトリーの用意」 に従って設定した Maven ミラーにアクセスできるように設定します。以下の変数を設定してください。
-
MAVEN_MIRROR_URL: 「オフラインで使用する Maven ミラーリポジトリーの用意」 で設定した Maven ミラーリポジトリーの URL。この URL は、OpenShift 環境の Pod からアクセスできるようにする必要があります。この Process Server を S2I として設定している場合は、この URL をすでに入力されています。 MAVEN_MIRROR_OF: ミラーから取得されるアーティファクトを定める値。この Process Server を S2I として設定している場合は、この値を設定しません。mirrorOf値の設定方法は、Apache Maven ドキュメントの Mirror Settings を参照してください。デフォルト値はexternal:*です。この値の場合、Maven はミラーから必要なアーティファクトをすべて取得し、他のリポジトリーにクエリーを送信しません。外部の Maven リポジトリー (
MAVEN_REPO_URL) を設定する場合は、ミラーからこのリポジトリー内のアーティファクトを除外するようにMAVEN_MIRROR_OFを変更します (例:external:*,!repo-custom)。repo-customは、MAVEN_REPO_IDで設定した ID に置き換えます。オーサリング環境でビルトイン Business Central Maven リポジトリーを使用する場合は、ミラーからこのリポジトリーのアーティファクトを除外するように
MAVEN_MIRROR_OFを変更します (例:external:*,!repo-rhpamcentr)。
-
-
Process Server デプロイメントを、Prometheus を使用してメトリクスを収集し、保存するように設定する必要がある場合は、
PROMETHEUS_SERVER_EXT_DISABLED環境変数をfalseに設定します。Prometheus メトリクス収集の方法については、{URL_MANAGING_SETTINGS}#prometheus-monitoring-ocp-proc_execution-server[Managing and monitoring Process Server]を参照してください。
次のステップ
追加の Process Server を設定するには、Add new KIE Server を再びクリックし、新規サーバー設定の手順を繰り返します。
デフォルト設定の Smart Router を使って環境をデプロイする必要がある場合には、Finish をクリックしてから Deploy をクリックして環境をデプロイします。それ以外の場合は、引き続き Smart Router の設定パラメーターの設定を行います。