第3章 OpenShift 環境への Red Hat Decision Manager のデプロイメント
OpenShift 環境に Red Hat Decision Manager をデプロイするには、Red Hat Decision Manager で用意した OpenShift テンプレートを使用します。
前提条件
「2章OpenShift 環境に Red Hat Decision Manager をデプロイする準備」に記載されている準備タスクを完了する必要があります。
OpenShift web UI を使用する代わりに、oc
コマンドラインツールを使用してテンプレートをデプロイし、パラメーターを設定できます。詳細は、使用する OpenShift バージョンのドキュメンテーションを参照してください。
3.1. Decision Central および Decision Server のデプロイメント
OpenShift インフラストラクチャーに、Decision Server とともに Decision Central をデプロイすることもできます。これにより、Decision Central を使用して Decision Server を管理し、新しいルールを開発できるようになります。
手順
In the OpenShift Web UI, select Add to Project
Browse Catalog, search for decision
, and then select the Red Hat Decision Manager 7.0 applications (Persistent with https) template.-
If this template is not available, download the
rhdm-7.0.1-openshift-templates.zip
product deliverable file from the Software Downloads page for Red Hat Decision Manager 7.0. Extract therhdm70-full.yaml
file. Select Add to ProjectImport YAML / JSON and then select or paste the rhdm70-full.yaml
file. In the Add Template window, ensure Process the template is selected and click Continue.
-
If this template is not available, download the
以下の必須パラメーターを設定します。
- Application Name: The name of the OpenShift application. It is used in the default URLs for Decision Central and Decision Server.
- Decision Central Server Certificate Name: The name of the certificate in the keystore that you created in 「Decision Central へのシークレットの作成」.
- Decision Central Server Keystore Password: The password for the keystore that you created in 「Decision Central へのシークレットの作成」.
- KIE Server Certificate Name: The name of the certificate in the keystore that you created in 「Decision Server にシークレットの作成」.
- KIE Server Keystore Password: The password for the keystore that you created in 「Decision Server にシークレットの作成」.
- KIE Server ID: The name of the server template on the Decision Central that the Decision Server is to join. Set this parameter to any value. If you do not set it and then the Decision Server pod is restarted or scaled, each new instance of the server might join a new template.
ImageStream Namespace: The namespace where the image streams are available. If the image streams were already available in your OpenShift environment (see 「イメージストリームが利用可能であることを確認」), the namespace is
openshift
. If you have installed the image streams file, the namespace is the name of the OpenShift project.You can also set other parameters as necessary. In particular, you can change the username and password for the Maven repository that is built into Decision Central. Use the Maven repository username and Maven repository password fields.
ATTENTION: Do not change the Maven repository URL field. If you change it, the Decision Server will work with a different Maven repository, but the Decision Central will still use its own built-in repository. Therefore, the Decision Central will not deploy services to the Decision Server.
- Create をクリックします。
3.2. S2I (Source to Image) を使用した Decision Server のデプロイメント
S2I (Source to Image) を使用して、OpenShift インフラストラクチャーに Decision Server をデプロイできます。この場合は、Git リポジトリーにデシジョンサービスを提供します。OpenShift は自動的にソースをビルドし、デシジョンサービスを Decision Server イメージにインストールし、サービスを開始します。イメージをこれ以上管理する必要はありません。新しいバージョンのデシジョンサービスを使用する場合は、新しいイメージをビルドします。このオプションは、コンテナーインフラストラクチャーにおける一般的なバージョン管理アプローチ (DevOps) でしばしば推奨されます。
HTTPS に対応の有無にかかわらず、S2I を使用して Decision Server をデプロイできます。
作業を開始する前の注意事項
デシジョンサービスの完全ソースコードが、OpenShift サーバーがアクセスできる Git リポジトリーで利用可能であることを確認します。ソースコードは Maven プロセスを使用してビルドされるため、pom.xml
ファイルが含まれる必要があります。
手順
In the OpenShift Web UI, select Add to Project
Browse Catalog, search for decision
, and then select the Red Hat Decision Manager Execution Server 7.0 S2I Ephemeral (no https) or Red Hat Decision Manager Execution Server 7.0 S2I (Ephemeral with https) template.-
If this template is not available, download the
rhdm-7.0.1-openshift-templates.zip
product deliverable file from the Software Downloads page for Red Hat Decision Manager 7.0. Extract therhdm70-kieserver-basic-s2i.yaml
orrhdm70-kieserver-https-s2i.yaml
file. Select Add to ProjectImport YAML / JSON and then select or paste the file. In the Add Template window, ensure Process the template is selected and click Continue.
-
If this template is not available, download the
以下の必須パラメーターを設定します。
- Application Name: The name of the OpenShift application. It is used in the default URLs for Decision Central and Decision Server.
- KIE Server Certificate Name: The name of the certificate in the keystore that you created in 「Decision Server にシークレットの作成」. Not available if you are configuring a server without HTTPS support.
- KIE Server Keystore Password: The password for the keystore that you created in 「Decision Server にシークレットの作成」. Not available if you are configuring a server without HTTPS support.
-
KIE Server Container Deployment: The identifying information of the decision service (KJAR file) that is built from your source. The format is:
<containerId>=<groupId>:<artifactId>:<version>
. You can provide two or more KJAR files using the|
separator, for example:containerId=groupId:artifactId:version|c2=g2:a2:v2
. The Maven build process must produce all these files from the source in the Git repository. - Git Repository URL: The URL for the Git repository that contains the source for your decision service.
- Git Reference: The branch in the Git repository
- Context Directory: The path to the source within the project downloaded from the Git repository
- Artefact Directory: The path within the project that contains the required binary files (KJAR files and any other necessary files) after a successful Maven build. Normally this directory is the target directory of the build. However, you can provide prebuilt binaries in this directory in the Git repository
ImageStream Namespace: The namespace where the image streams are available. If the image streams were already available in your OpenShift environment (see 「イメージストリームが利用可能であることを確認」), the namespace is
openshift
. If you have installed the image streams file, the namespace is the name of the OpenShift project.また、必要に応じて、その他のパラメーターを設定できます。特に、デシジョンサービスの Maven ビルドが Maven レポジトリーからパッケージをプルする場合は、ミラーリポジトリーの URL を設定でき、必要に応じて、ミラーリポジトリーにアクセスするためのユーザー名およびパスワードを設定できます。この場合、ビルドプロセスは、元のリポジトリーを設定する代わりに、ミラーリポジトリーからパッケージをプルします。
- Maven mirror URL
- Maven repository username
- Maven repository password
- Create をクリックします。
3.3. S2I (Source to Image) を使用しない Decision Server のデプロイメント
Decision Central および S2I を使用せずに Decision Server を OpenShift インフラストラクチャーにデプロイできます。この場合、Decision Server は Maven リポジトリーからデシジョンサービスを選択できます。サービスを自動的にロードするように Decision Server を設定できますが、Decision Central、コントローラー、または API を使用して Decision Server を管理することもできます。
作業を開始する前の注意事項
デシジョンサービスに Maven リポジトリーが利用できることを確認します。
Decision Central または管理コンソールを使用する場合は、それがインストールされており、KIE サーバーを制御するように設定が記録されていることを確認します。
手順
In the OpenShift Web UI, select Add to Project
Browse Catalog, search for decision
, and then select the Red Hat Decision Manager Execution Server 7.0 (Ephemeral with https) template.-
If this template is not available, download the
rhdm-7.0.1-openshift-templates.zip
product deliverable file from the Software Downloads page for Red Hat Decision Manager 7.0. Extract therhdm70-kieserver.yaml
. Select Add to ProjectImport YAML / JSON and then select or paste the rhdm70-kieserver.yaml
file. In the Add Template window, ensure Process the template is selected and click Continue.
-
If this template is not available, download the
以下の必須パラメーターを設定します。
- Application Name: The name of the OpenShift application. It is used in the default URLs for Decision Central and Decision Server.
- KIE Server Certificate Name: The name of the certificate in the keystore that you created in 「Decision Server にシークレットの作成」.
- KIE Server Keystore Password: The password for the keystore that you created in 「Decision Server にシークレットの作成」.
ImageStream Namespace: The name of the OpenShift project.
必要に応じて、以下のような、その他のパラメーターも設定できます。
デシジョンサービスを取得するために Maven リポジトリーを設定する場合は、以下のパラメーターにそのリポジトリーを設定します。
- Maven repository URL
- Maven repository username
- Maven repository password
デシジョンサービスを自動的にロードするように Decision Server を設定するには、以下のパラメーターを設定します。
-
KIE Server Container Deployment: The identifying information of the decision service (KJAR file). The format is:
<containerId>=<groupId>:<artifactId>:<version>
. You can provide two or more KJAR files using the|
separator, for example:containerId=groupId:artifactId:version|c2=g2:a2:v2
. The Decision Server pulls the files from the Maven repository.
-
KIE Server Container Deployment: The identifying information of the decision service (KJAR file). The format is:
同じ OpenShift インフラストラクチャーにデプロイした Decision Central を使用して Decision Server を管理するには、以下のパラメーターを設定します。
- KIE server controller service: The OpenShift service name for the Decision Central
- KIE server controller user: Decision Central にログオンするユーザー名
- KIE server controller password: The password for logging onto the Decision Central
- KIE Server ID: The name of the server template on the Decision Central that this server is to join.
Decision Central またはコントローラーを使用して Decision Server を管理する場合は、Decision Central の web ユーザーインターフェイスにアクセスするのに使用する URL、またはコントローラーの設定に従って、プロトコル、ホスト、ポートパラメーターを設定します。
- KIE server controller protocol (http または https)
- KIE server controller host
- KIE server controller port
- KIE server controller user: Decision Central またはコントローラーにログオンするユーザー名
- KIE server controller password: The password for logging onto the Decision Central or controller
- KIE Server ID: The name of the server template on the Decision Central or controller that this server is to join.
- Create をクリックします。