2.7. 外部データベースのカスタム Process Server 拡張イメージのビルド
Process Server に外部データベースサーバーを使用し、そのデータベースサーバーが MySQL または PostgreSQL 以外の場合は、環境をデプロイする前にこのサーバー用のドライバーを使用するカスタムの Process Server 拡張イメージをビルドする必要があります。
このビルド手順の手順を完了して、次のデータベースサーバーのいずれかにドライバーを提供します。
- Microsoft SQL Server
- MariaDB
- IBM DB2
- Oracle データベース
- Sybase
データベースサーバーのサポートされるバージョンについては、「 Red Hat Process Automation Manager 7 でサポートされる構成」を参照してください。
ビルド手順では、既存の Process Server イメージを拡張するカスタム拡張イメージを作成します。このカスタム拡張イメージは OpenShift 環境にインポートしてから、EXTENSIONS_IMAGE
パラメーターで参照する必要があります。
前提条件
-
oc
コマンドを使用して OpenShift 環境にログインしている。OpenShift ユーザーにはregistry-editor
ロールが必要です。 - Oracle Database または Sybase の場合は、データベースサーバーベンダーから JDBC ドライバーをダウンロードしている。
以下の必要なソフトウェアをインストールしている。
- Docker
- Cekit バージョン 3.2
Cekit の以下のライブラリーおよび拡張機能:
-
odcs-client
:python3-odcs-client
パッケージまたは同様のパッケージで提供される。 -
docker
:python3-docker
パッケージまたは同様のパッケージで提供される。 -
docker-squash
:python3-docker-squash
または同様のパッケージで提供される。 -
behave
:python3-behave
パッケージまたは同様のパッケージで提供される。 -
s2i
:source-to-image
パッケージまたは同様のパッケージで提供される。
-
手順
- IBM DB2、Oracle Database、または Sybase の場合、JDBC ドライバー JAR ファイルをローカルディレクトリーに指定します。
-
Red Hat カスタマーポータルの Software Downloads ページから利用可能な
rhpam-7.6.0-openshift-templates.zip
の製品配信可能ファイルをダウンロードします。 -
ファイルを展開し、コマンドラインで、展開したファイルの
templates/contrib/jdbc
ディレクトリーに変更します。このディレクトリーには、カスタムビルドのソースコードが含まれます。 データベースサーバーのタイプに応じて、以下のコマンドのいずれかを実行します。
Microsoft SQL Server の場合:
make build mssql
MariaDB の場合:
make build mariadb
IBM DB2 の場合:
make build db2
Oracle Database の場合:
make build oracle artifact=/tmp/ojdbc7.jar version=7.0
このコマンドで、
/tmp/ojdbc7.jar
をダウンロードされた Oracle Database ドライバーのパス名に置き換え、7.0
をドライバーのバージョンに置き換えます。Sybase の場合:
make build sybase artifact=/tmp/jconn4-16.0_PL05.jar version=16.0_PL05
このコマンドで、
/tmp/jconn4-16.0_PL05.jar
をダウンロードされた Sybase ドライバーのパス名に置き換え、16.0_PL05
をドライバーのバージョンに置き換えます。
以下のコマンドを実行して、ローカルで利用可能な Docker イメージを一覧表示します。
docker images
ビルドされたイメージの名前 (例:
jboss-kie-db2-extension-openshift-image
) およびイメージのバージョンタグ (11.1.4.4
など (latest
タグではない)) をメモします。-
OpenShift 環境のレジストリーに直接アクセスし、イメージをレジストリーにプッシュします。ユーザーパーミッションに応じて、イメージを
openshift
名前空間またはプロジェクト名前空間にプッシュできます。レジストリーへのアクセスおよびイメージのプッシュの手順については、「 Accessing the Registry Directly 」を参照してください。 外部データベースサーバーをサポートするテンプレートを使って Process Server デプロイメントを設定する場合、以下のパラメーターを設定します。
-
Drivers Extension Image (
EXTENSIONS_IMAGE
): 拡張イメージの ImageStreamTag 定義 (例:jboss-kie-db2-extension-openshift-image:11.1.4.4
) -
Drivers ImageStream Namespace (
EXTENSIONS_IMAGE_NAMESPACE
): 拡張イメージのアップロード先の名前空間 (例:openshift
またはプロジェクト名前空間)
-
Drivers Extension Image (