3.6. KIE 設定と ConfigMaps
Red Hat Decision Manager Operator をインストールすると、Operator は、現在の名前空間に対して kieconfig-$VERSION という接頭辞が付いた YAML ファイルである ConfigMaps を作成します。ConfigMap は、その名前空間の Red Hat Decision Manager コンポーネントの DeploymentConfigs、シークレット、ルート、およびサービスなどの機能の設定を含む YAML ファイルです。
ConfigMap の例
Operator は、ConfigMaps を使用してコンポーネントを設定およびデプロイします。これには、KIE Server、Smart Router、Business Central などのサポートされているすべての Red Hat Decision Manager コンポーネントと、永続ボリューム、ビルド設定、ルートなどのサービス関連の設定が含まれます。ConfigMap を手動で編集する場合、Operator は、環境が調整されるときに新しい値を使用してデプロイメントを作成します。
Red Hat Decision Manager Operator は、現在のバージョンと以前のバージョンの Red Hat Decision Manager コンポーネントを同時に使用でき、バージョンごとに ConfigMaps (7.13.0 と 7.12.1 など) を使用できます。
- kieconfigs-7.13.4
これには、
common.yaml設定ファイルが含まれています。詳細は、GitHub のcommon.yamlを参照してください。この設定ファイルを使用して、次のコンポーネントを設定できます。-
サーバーオブジェクトである KIE Server は、
## KIE Servers BEGINプレースホルダーで識別されます。 -
コンソールオブジェクトである Business Central と Business Central Monitoring は、
common.yamlの最初の行で定義されています。 -
smartrouter オブジェクトである Smartrouter は、
## KIE smartrouter BEGINプレースホルダーによって識別されます。
-
サーバーオブジェクトである KIE Server は、
kieconfigs-7.13.4 は、これら 3 つのコンポーネントに関連するルートとサービスも保持します。
- kieconfigs-7.13.4-dashbuilder
これには、Dashbuilder コンポーネントの設定 YAML ファイルが含まれています。
詳細は、GitHub の
rhpam-standalone-dashbuilder.yamlを参照してください。- kieconfigs-7.13.4-dbs
これには、MySQL および PostgreSQL データベースの基本的な
DeploymentConfigが含まれています。MySQL 設定の詳細は、GitHub の
mysql.yamlを参照してください。PostgreSQL 設定の詳細は、GitHub の
postgresql.yamlを参照してください。- kieconfigs-7.13.4-dbs-pim
これには、プロセスインスタンス移行 (PIM) がサポートするデータベース (external、MySQL、PostgreSQL) 用のスニペット設定が含まれています。
PIM 外部設定の詳細は、GitHub の
external.yamlを参照してください。PIM MySQL 設定の詳細は、GitHub の
mysql.yamlを参照してください。PIM PostgreSQL 設定の詳細は、GitHub の
postgresql.yamlを参照してください。注記これらの YAML ファイルは、この configMap の
application.propertiesを使用して設定された PIM データベースの特定の設定のみを保持します。- kieconfigs-7.13.4-dbs-servers
これには、サポートされているデータベース設定 (external、h2、MySQL、PostgreSQL) のスニペット設定が含まれています。
外部設定の詳細は、GitHub の
external.yamlを参照してください。h2 設定の詳細は、GitHub の h2
.yamlを参照してください。h2 設定は、実稼働環境ではサポートされていないことに注意してください。MySQL 設定の詳細は、GitHub の
mysql.yamlを参照してください。PostgreSQL 設定の詳細は、GitHub の
postgresql.yamlを参照してください。- kieconfigs-7.13.4-envs
これには、オーサリング環境やトライアル環境などの各 Red Hat Decision Manager 環境の特定の設定が含まれています。この ConfigMap には、次の YAML ファイルが含まれています。
- rhdm-authoring-ha.yaml
- rhdm-authoring.yaml
- rhdm-production-immutable.yaml
- rhdm-trial.yaml
- rhpam-authoring-ha.yaml
- rhpam-authoring.yaml
- rhpam-production-immutable.yaml
- rhpam-production.yaml
- rhpam-standalone-dashbuilder.yaml
rhpam-trial.yaml
各 Red Hat Decision Manager 環境の特定の設定の詳細は、GitHub の Red Hat Decision Manager 環境の ConfigMaps を参照してください。
- kieconfigs-7.13.4-jms
-
これには、JMS Executor が有効な場合の KIE Server の ActiveMQ 設定が含まれています。JMS Executor 設定の詳細は、GitHub の
activemq-jms-configを参照してください。 - kieconfigs-7.13.4-pim
-
これには、プロセスインスタンス移行 (PIM) DeploymentConfig と関連する PIM 設定が含まれています。MySQL またはその他のデータベースを PIM で使用している場合は、
kieconfigs-7.13.4-dbs-pimconfigMap を使用し、mysql.yamlファイルを編集する必要があります。
3.6.1. ConfigMaps の使用 リンクのコピーリンクがクリップボードにコピーされました!
ConfigMap を使用して Red Hat Decision Manager Operator をカスタマイズし、関連する設定を適用できます。ConfigMaps に変更を加えるには、oc コマンドツールまたは Red Hat OpenShift Container Platform コンソールを使用します。
前提条件
- 現在の名前空間に Operator がインストールされている。
- KieApp が利用できる。
kieconfig-$VERSION-*が利用可能です。kieconfig-$VERSION-*が利用可能かどうかを確認するには、次のコマンドを実行します。oc get cm | grep kieconfigs
$ oc get cm | grep kieconfigsCopy to Clipboard Copied! Toggle word wrap Toggle overflow oc get cm | grep kieconfigsの出力例。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
手順
Business Central と KIE Server 用にレプリカが 1 つある
rhpam-authoring environmentを作成します。rhpam-authoringの例:Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のいずれかの手順を実行します。
ocツールで特定の ConfigMap を開くには、以下のコマンドを実行します。oc edit cm/<CONFIGMAP_NAME>
$ oc edit cm/<CONFIGMAP_NAME>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記ocツールは、テキスト編集ツールのvimに似ています。-
Red Hat OpenShift Container Platform コンソールを使用して特定の ConfigMap を開くには、ConfigMaps ページで
kieconfigs-7.13.4に移動し、その YAML バージョンを開いて編集します。
YAML ファイルを変更するには、変更内容を含む
annotationsフィールドを追加します。以下に例を示します。Console.deploymentConfigs.metadataに以下を追加します。annotations: my.custom.annotation/v1: v1-rhpam-app-consoleannotations: my.custom.annotation/v1: v1-rhpam-app-consoleCopy to Clipboard Copied! Toggle word wrap Toggle overflow KIE Server を更新するには、
## KIE Servers Startプレースホルダー識別子に以下を追加します。annotations: my.custom.annotation/v1: v1-rhpam-app-kieserverannotations: my.custom.annotation/v1: v1-rhpam-app-kieserverCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記また、この ConfigMap を使用して、Smart Router の設定を編集することもできます。
変更を保存するには、次のいずれかの手順を実行します。
-
ocツールエディターで、変更を保存して終了するには、:wq!と入力します。 - Red Hat OpenShift Container Platform コンソールで、Red Hat OpenShift Container Platform コンソールを使用して変更を保存する場合は、Save をクリックします。
-
環境が実行されていて、Operator が変更されたコンポーネントの再デプロイメントを自動的に開始しなかった場合は、以下のステップを実行して、
ocコマンドツールを使用してターゲットコンポーネントの DeploymentConfig を手動で削除する必要があります。DeploymentConfig を返すには、以下のコマンドを実行する。
oc get dc
$ oc get dcCopy to Clipboard Copied! Toggle word wrap Toggle overflow oc get dcの出力が返されます。oc get dcの出力例です。oc get dc
$ oc get dc NAME REVISION DESIRED CURRENT TRIGGERED BY rhpam-authoring-kieserver 1 1 1 config rhpam-authoring-rhpamcentr 1 1 1 configCopy to Clipboard Copied! Toggle word wrap Toggle overflow 対象コンポーネントの DeploymentConfig を削除する場合は、以下のコマンドを実行すします。
oc delete dc/rhpam-authoring-kieserver
$ oc delete dc/rhpam-authoring-kieserverCopy to Clipboard Copied! Toggle word wrap Toggle overflow oc delete dc/rhpam-authoring-rhpamcentr
$ oc delete dc/rhpam-authoring-rhpamcentrCopy to Clipboard Copied! Toggle word wrap Toggle overflow デプロイメントは、ConfigMap で適用された変更内容で再デプロイされます。
KIE Server DeploymentConfig のアノテーションを確認することで、変更が適用されたことを確認するには、次のコマンドを実行します。
oc describe dc/rhpam-authoring-kieserver
$ oc describe dc/rhpam-authoring-kieserverCopy to Clipboard Copied! Toggle word wrap Toggle overflow oc describe dc/rhpam-authoring-kieserverの出力例です。Copy to Clipboard Copied! Toggle word wrap Toggle overflow