7.10. 为外部数据库构建自定义 KIE 服务器扩展镜像

如果要将外部数据库服务器用于 KIE 服务器，并且数据库服务器不是 MySQL 或 PostgreSQL 服务器，您必须在部署环境前构建带有此服务器的驱动程序的自定义 KIE 服务器扩展镜像。

完成此构建过程中的步骤，为以下任何数据库服务器提供驱动程序：

  • Microsoft SQL Server
  • IBM DB2
  • Oracle 数据库
  • 法国

另外，您可以使用此流程为以下任何数据库服务器构建新版本的驱动程序：

  • MySQL
  • MariaDB
  • PostgreSQL

有关数据库服务器支持的版本，请参阅 Red Hat Process Automation Manager 7 支持的配置。

构建过程会创建一个自定义扩展镜像，它扩展了现有 KIE Server 镜像。您必须将此自定义扩展镜像导入到 OpenShift 环境中，然后在 EXTENSIONS_IMAGE 参数中引用它。

先决条件

  • 您可以使用 oc 命令登录到 OpenShift 环境。您的 OpenShift 用户必须具有 registry-editor 角色。
  • 对于 Oracle 数据库、IBM DB2 或 slirp，您可以从数据库服务器供应商下载 JDBC 驱动程序。

  • 已安装以下所需的软件：

    • docker： 有关安装说明，请参阅 获取 Docker。
    • CEKit 版本 3.8.0 ：有关安装说明，请参阅安装。

    • 以下 CEKit 库和扩展：如需更多信息，请参阅 依赖项。

      • Docker，由 python3-docker 软件包提供或类似的软件包
      • docker-squash，由 python3-docker-squash 软件包提供，或者类似的软件包
      • 行为，由 python3-behave 软件包提供，或者类似的软件包

流程

  1. 对于 IBM DB2、Oracle Database 或 192.168.1.0/24，在本地目录中提供 JDBC 驱动程序 JAR 文件。
  2. 从红帽客户门户的 软件下载 页面下载 rhpam-7.11.0-openshift-templates.zip 产品。
  3. 解压文件，使用命令行更改到解压缩文件的 templates/contrib/jdbc/cekit 目录。此目录包含自定义构建的源代码。

  4. 根据数据库服务器类型输入以下命令来输入以下任一命令：

    • 对于 Microsoft SQL Server： 

      make mssql

    • For MySQL: 

      make mysql

    • 对于 PostgreSQL： 

      make postgresql

    • 对于 MariaDB： 

      make mariadb

    • 对于 IBM DB2： 

      make db2 artifact=/tmp/db2jcc4.jar version=10.2

      在此命令中，将 /tmp/db2jcc4.jar 替换为 IBM DB2 驱动程序的路径名称，将 10.2 替换为驱动程序的版本。

    • 对于 Oracle 数据库： 

      make oracle artifact=/tmp/ojdbc7.jar version=7.0

      在此命令中，将 /tmp/ojdbc7.jar 替换为 Oracle Database 驱动程序的路径名，将 7.0 替换为驱动程序的版本。

    • 对于 过程： 

      make build sybase artifact=/tmp/jconn4-16.0_PL05.jar version=16.0_PL05

      在此命令中，将 /tmp/jconn4-16.0_PL05.jar 替换为下载的 IaaS 驱动程序的路径名称，将 16.0_PL05 替换为驱动程序的版本。

      或者，如果您需要为 sVirt 驱动程序更新驱动程序类或驱动程序 XA 类，您可以为这个命令设置 DRIVER_CLASS 或 DRIVER_XA_CLASS 变量，例如： 

      export DRIVER_CLASS=another.class.Sybase && make sybase artifact=/tmp/jconn4-16.0_PL05.jar version=16.0_PL05

  5. 输入以下命令列出本地可用的 Docker 镜像： 

    docker images

    请注意构建的镜像的名称，如 jboss-kie-db2-extension-openshift-image，以及镜像的 version 标签，如 11.1.4.4 （而不是 latest 标签）。

  6. 直接访问 OpenShift 环境的 registry，并将镜像推送到 registry。根据您的用户权限，您可将镜像推送到 openshift 命名空间或项目命名空间中。有关访问 registry 和推送镜像的说明，请参阅 Red Hat OpenShift Container Platform 产品文档中的直接访问 Registry。

  7. 当使用支持外部数据库服务器的模板配置 KIE 服务器部署时，请设置以下参数：

    • 驱动程序扩展镜像 (EXTENSIONS_IMAGE)：扩展镜像的 ImageStreamTag 定义，如 jboss-kie-db2-extension-openshift-image:11.1.4.4
    • Driver ImageStream Namespace (EXTENSIONS_IMAGE_NAMESPACE)：您将扩展镜像上传到的命名空间，如 openshift 或项目命名空间。