15.4. rhpam712-prod-immutable-monitor.yaml template
Red Hat Process Automation Manager 7.12 向けの、実稼働環境のルーターおよび監視コンソールのアプリケーションテンプレート (非推奨)
15.4.1. パラメーター
テンプレートを使用すると、値を引き継ぐパラメーターを定義できます。この値は、パラメーターの参照時には、この値が代入されます。参照はオブジェクト一覧フィールドの任意のテキストフィールドで定義できます。詳細は、Openshift ドキュメント を参照してください。
変数名 | イメージの環境変数 | 説明 | 値の例 | 必須 |
---|---|---|---|---|
| — | アプリケーションの名前。 | myapp | True |
|
| maven リポジトリーに使用する id (設定されている場合)。デフォルトは無作為に作成されます。 | repo-custom | False |
|
| Maven リポジトリーまたはサービスへの完全修飾 URL。 | http://nexus.nexus-project.svc.cluster.local:8081/nexus/content/groups/public/ | False |
|
| Maven リポジトリーにアクセスするためのユーザー名 (必要な場合)。 | — | False |
|
| Maven リポジトリーにアクセスするパスワード (必要な場合)。 | — | False |
|
| maven リポジトリーの使用状況など、サービスのルックアップができるように任意の Business Central に到達可能な場合に使用するサービス名 (必要な場合) | myapp-rhpamcentr | False |
| — | KIE_ADMIN_USER 値および KIE_ADMIN_PWD 値を含むシークレット。 | rhpam-credentials | True |
|
| true に設定すると、KIE Server のグローバル検出機能はオンになります (org.kie.server.controller.openshift.global.discovery.enabled システムプロパティーを設定)。 | false | False |
|
| Business Central の OpenShift 統合がオンの場合は、このパラメーターを true に設定すると、OpenShift 内部サービスエンドポイント経由での KIE Server への接続が有効になります。(org.kie.server.controller.openshift.prefer.kieserver.service システムプロパティーを設定します) | true | False |
|
| KIE ServerTemplate Cache TTL (ミリ秒単位)(org.kie.server.controller.template.cache.ttl システムプロパティーを設定します)。 | 5000 | False |
| — | Red Hat Process Automation Manager イメージの ImageStream がインストールされている名前空間。これらの ImageStreams は通常 OpenShift の名前空間にインストールされています。ImageStream を異なる名前空間/プロジェクトにインストールしている場合にのみこれを変更する必要があります。デフォルトは openshift です。 | openshift | True |
| — | イメージストリーム内のイメージへの名前付きポインター。デフォルトは 7.12.0 です。 | 7.12.0 | False |
| — | http サービスルートのカスタムホスト名。デフォルトホスト名の場合は空白のままにします (例: insecure-<application-name>-smartrouter-<project>.<default-domain-suffix>)。 | — | False |
| — | https サービスルートのカスタムのホスト名。デフォルトのホスト名を使用する場合には空白にします (例: <application-name>-smartrouter-<project>.<default-domain-suffix>)。 | — | False |
|
| API 通信で使用されるルーター ID。(ルータープロパティー org.kie.server.router.id) | kie-server-router | True |
|
| KIE Server ルーターのプロトコル。(org.kie.server.router.url.external プロパティーのビルドに使用) | http | False |
|
| ルーターを見つけることのできるパブリック URL。形式: http://<host>:<port> (ルータープロパティー org.kie.server.router.url.external) | — | False |
|
| Business Central ユーザーインターフェイスで使用されるルーター名。(ルータープロパティー org.kie.server.router.name) | KIE Server ルーター | True |
| — | キーストアファイルを含むシークレット名。 | smartrouter-app-secret | True |
| — | シークレット内のキーストアファイルの名前。 | keystore.jks | False |
|
| サーバー証明書に関連付けられている名前。 | jboss | False |
|
| キーストアおよび証明書のパスワード。 | mykeystorepass | False |
|
| ベアラー認証用の KIE Server モニタートークン。(org.kie.server.controller.token システムプロパティーを設定) | — | False |
|
| http サービスルートのカスタムホスト名。デフォルトのホスト名を使用する場合は空白にします (例: insecure-<application-name>-rhpamcentrmon-<project>.<default-domain-suffix>)。 | — | False |
|
| https サービスルートのカスタムのホスト名。デフォルトのホスト名を使用する場合は空白にします (例: <application-name>-rhpamcentrmon-<project>.<default-domain-suffix>)。 | — | False |
| — | キーストアファイルを含むシークレット名。 | businesscentral-app-secret | True |
|
| シークレット内のキーストアファイルの名前。 | keystore.jks | False |
|
| サーバー証明書に関連付けられている名前 | jboss | False |
|
| キーストアおよび証明書のパスワード。 | mykeystorepass | False |
| — | Business Central コンテナーのメモリー制限。 | 2Gi | True |
| — | Business Central コンテナーのメモリー要求。 | 1536Mi | True |
| — | Business Central コンテナーの CPU 制限。 | 1 | True |
| — | Business Central コンテナーの CPU 要求。 | 750m | True |
| — | Smart Router コンテナーのメモリー制限 | 512Mi | False |
|
| RH-SSO URL。 | https://rh-sso.example.com/auth | False |
|
| RH-SSO レルム名。 | — | False |
|
| Business Central Monitoring RH-SSO クライアント名。 | — | False |
|
| Business Central Monitoring RH-SSO クライアントシークレット。 | 252793ed-7118-4ca8-8dab-5622fa97d892 | False |
|
| クライアント作成に使用する RH-SSO レルムの管理者ユーザー名 (存在しない場合) | — | False |
|
| クライアント作成に使用する RH-SSO レルムの管理者のパスワード。 | — | False |
|
| RH-SSO が無効な SSL 証明書の検証。 | false | False |
|
| ユーザー名として使用する RH-SSO プリンシパル属性。 | preferred_username | False |
|
| 認証用に接続する LDAP エンドポイント。フェイルオーバーの場合は、2 つ以上の LDAP エンドポイントをスペースで区切って設定します。 | ldap://myldap.example.com:389 | False |
|
| LDAP ログインモジュールフラグは、Elytron のレガシーセキュリティーサブシステムとの下位互換性を追加します。'optional' は唯一のサポートされる値で、設定されている場合、KIE_ADMIN_USER を使用して追加されたユーザーの LDAP および FileSystem レルムを持つ Elytron 設定の分散レルムが作成されます。 | 任意 | False |
|
| フェイルオーバーを有効にします。LDAP Url に到達できない場合には、KieFsRealm にフェイルオーバーします。 | true | False |
|
| 認証に使用するバインド DN | uid=admin,ou=users,ou=example,ou=com | False |
|
| 認証に使用する LDAP の認証情報 | パスワード | False |
|
| ユーザー検索を開始する最上位コンテキストの LDAP ベース DN | ou=users,ou=example,ou=com | False |
|
| 認証するユーザーのコンテキストの検索に使用する LDAP 検索フィルター。{0} 式を使用しているフィルターに、入力ユーザー名、またはログインモジュールコールバックから取得した userDN が置換されます。検索フィルターの一般的な例は (uid={0}) です。 | (uid={0}) | False |
|
| ユーザーのクエリーが再帰的であるかどうかを示します。 | true | False |
|
| ユーザーまたはロールの検索のタイムアウト (ミリ秒単位)。 | 10000 | False |
|
| ユーザーロールを含む属性の名前。 | memberOf | False |
|
| ユーザーロールを検索するコンテキストの固定 DN。これは、実際のロールが存在する DN ではなく、ユーザーロールを含むオブジェクトが存在する DN です。たとえば、Microsoft Active Directory サーバーでは、これは、ユーザーアカウントが存在する DN です。 | ou=groups,ou=example,ou=com | False |
|
| 認証済みユーザーと関連付けられたロールを検索するために使用される検索フィルター。{0} 式を使用しているフィルターに、入力ユーザー名、またはログインモジュールコールバックから取得した userDN が置換されます。認証済み userDN は {1} が使用されたフィルターに置き換えられます。入力ユーザー名に一致する検索フィルター例は (member={0}) です。認証済み userDN に一致する他の例は (member={1}) です。 | (memberOf={1}) | False |
|
| ロール検索が一致するコンテキストで行われる再帰のレベル数。再帰を無効にするには、これを 0 に設定します。 | 1 | False |
|
| 認証された全ユーザーに対して含まれるロール。 | user | False |
|
| LDAP ID マッピングに新しいアイデンティティーを提供します。この env で使用されるパターンは 'attribute_name=attribute_value;another_attribute_name=value' です。 | sn=BlankSurname;cn=BlankCommonName | False |
|
| LDAP リファーラルに従う必要がある場合。REFERRAL ('java.naming.referral') 環境プロパティーに対応します。使用できる値は 'ignore'、'follow'、'throw' です。 | — | False |
|
| 存在する場合は、提供されたプロパティーファイルまたはロールを使用するように RoleMapping が設定されます。このパラメーターは、プロパティーファイルの完全修飾ファイルパスと名前、または次のパターン 'role=role1;another-role=role2' を持つロールのセットを定義します。ファイルのすべてのエントリーの形式は original_role=role1,role2,role3 になります。 | role=role1,role3,role4;role7=role,admin | False |
|
| true に設定すると、マップされたロールは定義されたマッピングを持つすべてのロールを保持します。 | — | False |
|
| true に設定すると、マップされたロールは、定義されたマッピングのないすべてのロールを保持します。 | — | False |
15.4.2. オブジェクト
CLI はさまざまなオブジェクトタイプをサポートします。これらのオブジェクトタイプの一覧や略語については、Openshift ドキュメント を参照してください。
15.4.2.1. サービス
サービスは、Pod の論理セットや、Pod にアクセスするためのポリシーを定義する抽象概念です。詳細は、コンテナーエンジンのドキュメント を参照してください。
サービス | ポート | 名前 | 説明 |
---|---|---|---|
| 8080 | http | すべての Business Central Monitoring Web サーバーのポート。 |
8443 | https | ||
| 9000 | http | smart router サーバーの http ポートおよび https ポート |
9443 | https |
15.4.2.2. ルート
ルートは、www.example.com
などの外部から到達可能なホスト名を指定してサービスを公開する 1 つの手段です。ルーターは、定義したルートや、サービスで特定したエンドポイントを使用して、外部のクライアントからアプリケーションに名前付きの接続を提供します。各ルートは、ルート名、サービスセレクター、セキュリティー設定 (任意) で設定されます。詳細は、Openshift ドキュメント を参照してください。
サービス | セキュリティー | ホスト名 |
---|---|---|
insecure-${APPLICATION_NAME}-rhpamcentrmon-http | なし |
|
| TLS パススルー |
|
insecure-${APPLICATION_NAME}-smartrouter-http | なし |
|
| TLS パススルー |
|
15.4.2.3. デプロイメント設定
OpenShift のデプロイメントは、デプロイメント設定と呼ばれるユーザー定義のテンプレートをベースとするレプリケーションコントローラーです。デプロイメントは手動で作成されるか、トリガーされたイベントに対応するために作成されます。詳細は、Openshift ドキュメント を参照してください。
15.4.2.3.1. トリガー
トリガーは、OpenShift 内外を問わず、イベントが発生すると新規デプロイメントを作成するように促します。詳細は、Openshift ドキュメント を参照してください。
デプロイメント | トリガー |
---|---|
| ImageChange |
| ImageChange |
15.4.2.3.2. レプリカ
レプリケーションコントローラーを使用すると、指定した数だけ、Pod のレプリカを一度に実行させることができます。レプリカが増えると、レプリケーションコントローラーが Pod の一部を終了させます。レプリカが足りない場合には、起動させます。詳細は、コンテナーエンジンのドキュメント を参照してください。
デプロイメント | レプリカ |
---|---|
| 1 |
| 2 |
15.4.2.3.3. Pod テンプレート
15.4.2.3.3.1. サービスアカウント
サービスアカウントは、各プロジェクト内に存在する API オブジェクトです。他の API オブジェクトのように作成し、削除できます。詳細は、Openshift ドキュメント を参照してください。
デプロイメント | サービスアカウント |
---|---|
|
|
|
|
15.4.2.3.3.2. イメージ
デプロイメント | イメージ |
---|---|
| rhpam-businesscentral-monitoring-rhel8 |
| rhpam-smartrouter-rhel8 |
15.4.2.3.3.3. Readiness Probe
${APPLICATION_NAME}-rhpamcentrmon
Http Get on http://localhost:8080/rest/ready
15.4.2.3.3.4. Liveness Probe
${APPLICATION_NAME}-rhpamcentrmon
Http Get on http://localhost:8080/rest/healthy
15.4.2.3.3.5. 公開されたポート
デプロイメント | 名前 | ポート | プロトコル |
---|---|---|---|
| jolokia | 8778 |
|
http | 8080 |
| |
https | 8443 |
| |
| http | 9000 |
|
15.4.2.3.3.6. イメージの環境変数
デプロイメント | 変数名 | 説明 | 値の例 |
---|---|---|---|
|
| — |
|
| — |
| |
| 管理ユーザー名。 | 認証情報のシークレットに合わせて設定 | |
| 管理ユーザーのパスワード。 | 認証情報のシークレットに合わせて設定 | |
| — | RHPAMCENTR,EXTERNAL | |
| — | repo-rhpamcentr | |
| maven リポジトリーの使用状況など、サービスのルックアップができるように任意の Business Central に到達可能な場合に使用するサービス名 (必要な場合) |
| |
| — |
| |
| — | 認証情報のシークレットに合わせて設定 | |
| — | 認証情報のシークレットに合わせて設定 | |
| maven リポジトリーに使用する id (設定されている場合)。デフォルトは無作為に作成されます。 |
| |
| Maven リポジトリーまたはサービスへの完全修飾 URL。 |
| |
| Maven リポジトリーにアクセスするためのユーザー名 (必要な場合)。 |
| |
| Maven リポジトリーにアクセスするパスワード (必要な場合)。 |
| |
| — | true | |
| true に設定すると、KIE Server のグローバル検出機能はオンになります (org.kie.server.controller.openshift.global.discovery.enabled システムプロパティーを設定)。 |
| |
| Business Central の OpenShift 統合がオンの場合は、このパラメーターを true に設定すると、OpenShift 内部サービスエンドポイント経由での KIE Server への接続が有効になります。(org.kie.server.controller.openshift.prefer.kieserver.service システムプロパティーを設定します) |
| |
| KIE ServerTemplate Cache TTL (ミリ秒単位)(org.kie.server.controller.template.cache.ttl システムプロパティーを設定します)。 |
| |
| ベアラー認証用の KIE Server モニタートークン。(org.kie.server.controller.token システムプロパティーを設定) |
| |
| — |
| |
| シークレット内のキーストアファイルの名前。 |
| |
| サーバー証明書に関連付けられている名前。 |
| |
| キーストアおよび証明書のパスワード。 |
| |
| — | kubernetes.KUBE_PING | |
| — | — | |
| — | cluster=jgrp.k8s.${APPLICATION_NAME}.rhpamcentrmon | |
| RH-SSO URL。 |
| |
| — | ROOT.war | |
| RH-SSO レルム名。 |
| |
| Business Central Monitoring RH-SSO クライアントシークレット。 |
| |
| Business Central Monitoring RH-SSO クライアント名。 |
| |
| クライアント作成に使用する RH-SSO レルムの管理者ユーザー名 (存在しない場合) |
| |
| クライアント作成に使用する RH-SSO レルムの管理者のパスワード。 |
| |
| RH-SSO が無効な SSL 証明書の検証。 |
| |
| ユーザー名として使用する RH-SSO プリンシパル属性。 |
| |
| http サービスルートのカスタムホスト名。デフォルトのホスト名を使用する場合は空白にします (例: insecure-<application-name>-rhpamcentrmon-<project>.<default-domain-suffix>)。 |
| |
| https サービスルートのカスタムのホスト名。デフォルトのホスト名を使用する場合は空白にします (例: <application-name>-rhpamcentrmon-<project>.<default-domain-suffix>)。 |
| |
| 認証用に接続する LDAP エンドポイント。フェイルオーバーの場合は、2 つ以上の LDAP エンドポイントをスペースで区切って設定します。 |
| |
| LDAP ログインモジュールフラグは、Elytron のレガシーセキュリティーサブシステムとの下位互換性を追加します。'optional' は唯一のサポートされる値で、設定されている場合、KIE_ADMIN_USER を使用して追加されたユーザーの LDAP および FileSystem レルムを持つ Elytron 設定の分散レルムが作成されます。 |
| |
| フェイルオーバーを有効にします。LDAP Url に到達できない場合には、KieFsRealm にフェイルオーバーします。 |
| |
| 認証に使用するバインド DN |
| |
| 認証に使用する LDAP の認証情報 |
| |
| ユーザー検索を開始する最上位コンテキストの LDAP ベース DN |
| |
| 認証するユーザーのコンテキストの検索に使用する LDAP 検索フィルター。{0} 式を使用しているフィルターに、入力ユーザー名、またはログインモジュールコールバックから取得した userDN が置換されます。検索フィルターの一般的な例は (uid={0}) です。 |
| |
| ユーザーのクエリーが再帰的であるかどうかを示します。 |
| |
| ユーザーまたはロールの検索のタイムアウト (ミリ秒単位)。 |
| |
| ユーザーロールを含む属性の名前。 |
| |
| ユーザーロールを検索するコンテキストの固定 DN。これは、実際のロールが存在する DN ではなく、ユーザーロールを含むオブジェクトが存在する DN です。たとえば、Microsoft Active Directory サーバーでは、これは、ユーザーアカウントが存在する DN です。 |
| |
| 認証済みユーザーと関連付けられたロールを検索するために使用される検索フィルター。{0} 式を使用しているフィルターに、入力ユーザー名、またはログインモジュールコールバックから取得した userDN が置換されます。認証済み userDN は {1} が使用されたフィルターに置き換えられます。入力ユーザー名に一致する検索フィルター例は (member={0}) です。認証済み userDN に一致する他の例は (member={1}) です。 |
| |
| ロール検索が一致するコンテキストで行われる再帰のレベル数。再帰を無効にするには、これを 0 に設定します。 |
| |
| 認証された全ユーザーに対して含まれるロール。 |
| |
| LDAP ID マッピングに新しいアイデンティティーを提供します。この env で使用されるパターンは 'attribute_name=attribute_value;another_attribute_name=value' です。 |
| |
| LDAP リファーラルに従う必要がある場合。REFERRAL ('java.naming.referral') 環境プロパティーに対応します。使用できる値は 'ignore'、'follow'、'throw' です。 |
| |
| 存在する場合は、提供されたプロパティーファイルまたはロールを使用するように RoleMapping が設定されます。このパラメーターは、プロパティーファイルの完全修飾ファイルパスと名前、または次のパターン 'role=role1;another-role=role2' を持つロールのセットを定義します。ファイルのすべてのエントリーの形式は original_role=role1,role2,role3 になります。 |
| |
| true に設定すると、マップされたロールは定義されたマッピングを持つすべてのロールを保持します。 |
| |
| true に設定すると、マップされたロールは、定義されたマッピングのないすべてのロールを保持します。 |
| |
|
| — | — |
| — | 9000 | |
| — | 9443 | |
| ルーターを見つけることのできるパブリック URL。形式: http://<host>:<port> (ルータープロパティー org.kie.server.router.url.external) |
| |
| API 通信で使用されるルーター ID。(ルータープロパティー org.kie.server.router.id) |
| |
| Business Central ユーザーインターフェイスで使用されるルーター名。(ルータープロパティー org.kie.server.router.name) |
| |
| — |
| |
| — |
| |
| KIE Server ルーターのプロトコル。(org.kie.server.router.url.external プロパティーのビルドに使用) |
| |
| サーバー証明書に関連付けられている名前。 |
| |
| キーストアおよび証明書のパスワード。 |
| |
| — |
| |
| 管理ユーザー名。 | 認証情報のシークレットに合わせて設定 | |
| 管理ユーザーのパスワード。 | 認証情報のシークレットに合わせて設定 | |
| ベアラー認証用の KIE Server モニタートークン。(org.kie.server.controller.token システムプロパティーを設定) |
| |
| — |
| |
| — | http | |
| — |
| |
| — | true |
15.4.2.3.3.7. ボリューム
デプロイメント | 名前 | mountPath | 目的 | readOnly |
---|---|---|---|---|
| businesscentral-keystore-volume |
| ssl certs | True |
|
|
| — | false |
15.4.2.4. 外部の依存関係
15.4.2.4.1. ボリューム要求
PersistentVolume
オブジェクトは、OpenShift クラスターのストレージリソースです。管理者が GCE Persistent Disks、AWS Elastic Block Store (EBS)、NFS マウントなどのソースから PersistentVolume
オブジェクトを作成して、ストレージをプロビジョニングします。詳細は、Openshift ドキュメント を参照してください。
名前 | アクセスモード |
---|---|
| ReadWriteMany |
| ReadWriteMany |
15.4.2.4.2. シークレット
このテンプレートでは、アプリケーションを実行するために以下のシークレットをインストールする必要があります。
- smartrouter-app-secret
- businesscentral-app-secret