第 9 章 编写环境
您可以使用 Business Central 部署环境以创建和修改进程。它由用于编写工作的 Business Central 和 KIE 服务器组成,用于测试进程的执行。如果需要,您可以将额外的 KIE 服务器连接到 Business Central。
根据您的需要,您可以部署单个编写环境模板或高可用性(HA)编写环境模板。
单个编写环境包含两个 pod。其中一个 pod 运行 Business Central,另一个运行 KIE Server。KIE 服务器默认包含一个嵌入式 H2 数据库引擎。此环境最适用于单用户编写,或者 OpenShift 基础架构有限资源时。它不需要支持 ReadWriteMany
访问模式的持久性卷。
在单个编写环境中,您无法扩展 Business Central。默认情况下,您无法扩展 KIE 服务器,因为 H2 数据库引擎不支持扩展。但是,您可以修改模板以使用单独的 MySQL 或 PostgreSQL 数据库服务器 pod;在这种情况下,您可以扩展 KIE Server。有关修改单个编写环境模板的步骤,请参阅 第 9.3 节 “修改单个编写环境的模板”。
在 HA 编写环境中,Business Central 和 KIE 服务器都在可扩展的 pod 中提供。当 pod 扩展时,持久性存储会在副本之间共享。数据库由单独的 pod 提供。
要在 Business Central 中启用高可用性功能,需要带有 AMQ 和 Data Grid 的额外 pod。这些 pod 由高可用性编写模板配置和部署。使用高可用性编写环境提供最大可靠性和响应性,特别是当同时涉及多个用户时。
在 Red Hat Process Automation Manager 的当前版本中,支持 HA 编写的环境,但有一些限制:
- 如果 Business Central pod 在用户使用时崩溃,用户可以得到错误消息,然后重定向到另一个 pod。不需要再次登录。
- 如果 Business Central pod 在用户操作过程中崩溃,则未提交(保存)的数据可能会丢失。
- 如果 Business Central pod 在创建项目过程中崩溃,则可能会创建一个不可用的项目。
- 如果 Business Central pod 在创建资产过程中崩溃,则可能会创建资产但不会索引,因此无法使用它。用户可以在 Business Central 中打开资产,并再次保存它使其索引。
- 当用户将服务部署到 KIE 服务器时,KIE 服务器部署会再次推出。在推出完成前,用户无法将另一个服务部署到同一 KIE 服务器中。
在高可用性编写环境中,您也可以根据需要部署额外的受管或不可变 KIE 服务器。Business Central 可以自动发现同一命名空间中的所有 KIE 服务器,包括不可变 KIE 服务器和受管 KIE 服务器。
如果要在单一编写环境中部署额外的管理或不可变 KIE 服务器,您必须完成一个额外手动步骤以便在环境中启用 OpenShiftStartupStrategy
设置,如 ] 所述。此设置允许发现其他 KIE 服务器。
有关部署受管 KIE 服务器的步骤,请参考 第 11.2 节 “为自由格式环境部署额外的受管 KIE 服务器”。
有关部署不可变 KIE 服务器的步骤,请参考 第 10.2 节 “使用 S2I 构建部署不可变 KIE 服务器” 和 第 10.4 节 “从 KJAR 服务部署不可变 KIE 服务器”。
9.1. 部署编写环境
您可以使用 OpenShift 模板来部署单一或高可用性编写环境。此环境由 Business Central 和一个 KIE 服务器组成。
9.1.1. 为编写环境启动模板配置
如果要部署单个编写环境,请使用 rhpam711-authoring.yaml
模板文件。默认情况下,单个编写模板使用带有持久性存储的 H2 数据库。如果您希望创建 MySQL 或 PostgreSQL pod 或使用外部数据库服务器(在 OpenShift 项目之外),请在部署环境前修改模板。有关修改模板的步骤,请参考 第 9.3 节 “修改单个编写环境的模板”。
如果要部署高可用性编写环境,请使用 rhpam711-authoring-ha.yaml
模板文件。默认情况下,高可用性编写模板会创建一个 MySQL pod,以便为 KIE 服务器提供数据库服务器。如果要使用 PostgreSQL 或使用外部服务器(在 OpenShift 项目之外),则需要在部署环境前修改模板。您还可以修改模板,以更改最初为 Business Central 创建的副本数。有关修改模板的步骤,请参考 第 9.4 节 “修改高可用性编写环境的模板”。
流程
-
从红帽客户门户的 软件下载 页面下载
rhpam-7.11.0-openshift-templates.zip
产品。 - 提取所需的模板文件。
使用以下方法之一开始部署模板:
-
要使用 OpenShift Web UI,在 OpenShift 应用程序控制台中选择 Add to Project
Import YAML / JSON,然后选择或粘贴 < template-file-name>.yaml
文件。在 Add Template 窗口中,确保选择了 Process,然后单击 Continue。 要使用 OpenShift 命令行控制台,准备以下命令行:
oc new-app -f <template-path>/<template-file-name>.yaml -p BUSINESS_CENTRAL_HTTPS_SECRET=businesscentral-app-secret -p KIE_SERVER_HTTPS_SECRET=kieserver-app-secret -p PARAMETER=value
在这个命令行中,进行以下更改:
-
将
<template-path
> 替换为下载的模板文件的路径。 -
将
<template-file-name
> 替换为模板文件的名称。 -
根据需要使用多个
-p PARAMETER=value
对来设置所需参数。
-
将
-
要使用 OpenShift Web UI,在 OpenShift 应用程序控制台中选择 Add to Project
后续步骤
设置模板的参数。按照 第 9.1.2 节 “为编写的环境设置所需的参数” 中的步骤设置通用参数。您可以查看模板文件以查看所有参数的描述。
9.1.2. 为编写的环境设置所需的参数
在配置模板以部署编写环境时,您必须在所有情况下设置以下参数。
先决条件
- 您启动了模板的配置,如 第 9.1.1 节 “为编写环境启动模板配置” 所述。
流程
设置以下参数:
-
凭证 secret (
CREDENTIALS_SECRET
):包含管理用户凭证的 secret 名称,如 第 7.5 节 “为管理用户创建 secret” 中创建的。 -
Business Central Server Keystore Secret Name (
BUSINESS_CENTRAL_HTTPS_SECRET
): Business Central 的 secret 名称,如 第 7.3 节 “为 Business Central 创建 secret” 中创建的。 -
KIE Server Keystore Secret Name (
KIE_SERVER_HTTPS_SECRET
): KIE 服务器的 secret 名称,如 第 7.2 节 “为 KIE 服务器创建 secret” 中创建的。 -
Business Central Server Certificate Name (
BUSINESS_CENTRAL_HTTPS_NAME
):您在 第 7.3 节 “为 Business Central 创建 secret” 中创建的密钥存储中证书的名称。 -
Business Central Server Keystore Password (
BUSINESS_CENTRAL_HTTPS_PASSWORD
): 您在 第 7.3 节 “为 Business Central 创建 secret” 中创建的密钥存储的密码。 -
KIE Server Certificate Name (
KIE_SERVER_HTTPS_NAME
):您在 第 7.2 节 “为 KIE 服务器创建 secret” 中创建的密钥存储中证书名称。 -
KIE Server Keystore Password (
KIE_SERVER_HTTPS_PASSWORD
): 您在 第 7.2 节 “为 KIE 服务器创建 secret” 中创建的密钥存储的密码。 -
应用名称 (
APPLICATION_NAME
):OpenShift 应用的名称。它用于 Business Central Monitoring 和 KIE Server 的默认 URL。OpenShift 使用应用程序名称创建一组单独的部署配置、服务、路由、标签和工件。 -
镜像流命名空间(
IMAGE_STREAM_NAMESPACE
):镜像流可用的命名空间。如果您的 OpenShift 环境中已有镜像流(请参阅 第 7.1 节 “确保镜像流和镜像 registry 的可用性”),则命名空间为openshift
。如果安装了镜像流文件,则 namespace 是 OpenShift 项目的名称。
-
凭证 secret (
后续步骤
如有必要,设置附加参数。
要完成部署,请按照 第 9.1.13 节 “为编写环境完成模板部署” 中的步骤操作。
9.1.3. 为编写的环境配置镜像流命名空间
如果您在不是 openshift
的命名空间中创建镜像流,则必须在模板中配置命名空间。
如果 Red Hat OpenShift Container Platform 环境中已提供了所有镜像流,您可以跳过这个过程。
先决条件
- 您启动了模板的配置,如 第 9.1.1 节 “为编写环境启动模板配置” 所述。
流程
如果您根据 第 7.1 节 “确保镜像流和镜像 registry 的可用性” 中的说明安装了镜像流文件,请将 ImageStream Namespace (IMAGE_STREAM_NAMESPACE
)参数设置为 OpenShift 项目的名称。
9.1.4. 为编写环境设置可选的 Maven 存储库
将模板配置为部署编写环境时,如果要将构建的 KJAR 文件放在外部 Maven 存储库中,您必须设置参数来访问存储库。
先决条件
- 您启动了模板的配置,如 第 9.1.1 节 “为编写环境启动模板配置” 所述。
流程
要配置对自定义 Maven 存储库的访问权限,请设置以下参数:
-
Maven 存储库 URL (
MAVEN_REPO_URL
): Maven 存储库的 URL。 -
Maven 存储库 ID (
MAVEN_REPO_ID
):Maven 存储库的标识符。默认值为repo-custom
。 -
Maven 存储库用户名 (
MAVEN_REPO_USERNAME
):Maven 存储库的用户名。 -
Maven 存储库密码 (
MAVEN_REPO_PASSWORD
):Maven 存储库的密码。
后续步骤
如有必要,设置附加参数。
要完成部署,请按照 第 9.1.13 节 “为编写环境完成模板部署” 中的步骤操作。
要将 Business Central 项目导出或推送为 KJAR 工件到外部 Maven 存储库,还必须在每个项目的 pom.xml
文件中添加存储库信息。有关将 Business Central 项目导出到外部存储库的详情,请参考 打包和部署 Red Hat Process Automation Manager 项目。
9.1.5. 在没有连接到公共互联网的环境中为编写的环境配置对 Maven 镜像的访问
当将模板配置为部署编写环境时,如果您的 OpenShift 环境没有与公共互联网的连接,您必须配置对根据 第 7.9 节 “准备 Maven 镜像存储库以供离线使用” 设置的 Maven 镜像的访问权限。
先决条件
- 您启动了模板的配置,如 第 9.1.1 节 “为编写环境启动模板配置” 所述。
流程
要配置对 Maven 镜像的访问,请设置以下参数:
-
Maven 镜像 URL (
MAVEN_MIRROR_URL
):您在 第 7.9 节 “准备 Maven 镜像存储库以供离线使用” 中设置 Maven 镜像存储库的 URL。此 URL 必须可从 OpenShift 环境中的容器集访问。 Maven 镜像 (
MAVEN_MIRROR_OF
):决定要从镜像检索哪些工件的值。有关设置mirrorOf
值的说明,请参阅 Apache Maven 文档中的 镜像设置。https://maven.apache.org/guides/mini/guide-mirror-settings.html默认值为external:!repo-rhpamcentr
;使用此值,Maven 直接从 Business Central 的内置 Maven 存储库检索工件,并从镜像检索任何其他所需的工件。如果您配置了外部 Maven 存储库(MAVEN_REPO_URL
),请更改MAVEN_MIRROR_OF
以排除此存储库中的工件,例如external:114,!repo-custom
。将repo-custom
替换为您在MAVEN_REPO_ID
中配置的 ID。默认值为external:114
。使用此值时,Maven 从镜像检索每个所需的工件,且不会查询任何其他存储库。-
如果您配置了外部 Maven 存储库(
MAVEN_REPO_URL
),请将MAVEN_MIRROR_OF
更改为将此存储库中的工件从镜像中排除,例如external:598,!repo-custom
。将repo-custom
替换为您在MAVEN_REPO_ID
中配置的 ID。 -
如果您配置内置的 Business Central Maven 存储库(
BUSINESS_CENTRAL_MAVEN_SERVICE
),请更改MAVEN_MIRROR_OF
以将此存储库中的工件排除在 mirror:external:39),!repo-rhpamcentr
。 -
如果您配置了这两个软件仓库,请更改
MAVEN_MIRROR_OF
,以从镜像中排除两个存储库中的工件:external: the the!repo-rhpamcentr,!repo-custom
。将repo-custom
替换为您在MAVEN_REPO_ID
中配置的 ID。
-
如果您配置了外部 Maven 存储库(
后续步骤
如有必要,设置附加参数。
要完成部署,请按照 第 9.1.13 节 “为编写环境完成模板部署” 中的步骤操作。
9.1.6. 为高可用性编写环境配置 Business Central 和 KIE 服务器副本
如果您要部署高可用性编写环境,默认情况下会创建两个 Business Central 副本,并且最初创建 KIE 服务器的两个副本。
另外,您可以修改副本数量。
对于单一编写的环境跳过这个过程。
先决条件
- 您启动了模板的配置,如 第 9.1.1 节 “为编写环境启动模板配置” 所述。
流程
要修改初始副本数,请设置以下参数:
-
Business Central Container Replicas (
BUSINESS_CENTRAL_CONTAINER_REPLICAS
):部署最初为 Business Central 创建的副本数。 -
KIE Server Container Replicas (
KIE_SERVER_CONTAINER_REPLICAS
):部署最初为 KIE 服务器创建的副本数。
后续步骤
如有必要,设置附加参数。
要完成部署,请按照 第 9.1.13 节 “为编写环境完成模板部署” 中的步骤操作。
9.1.7. 为编写环境指定 Git hook 目录
您可以使用 Git hook 来促进 Business Central 的内部 Git 存储库和外部 Git 存储库之间的交互。
如果要使用 Git hook,您必须配置 Git hook 目录。
先决条件
- 您启动了模板的配置,如 第 9.1.1 节 “为编写环境启动模板配置” 所述。
流程
要配置 Git hook 目录,请设置以下参数:
-
Git hook 目录 (
GIT_HOOKS_DIR
):到 Git hook 目录的完全限定路径,如/opt/kie/data/git/hooks
。您必须提供此目录的内容并将其挂载到指定路径中。有关使用配置映射或持久性卷提供和挂载 Git hook 目录的说明,请参阅 第 13.1 节 “(可选)提供 Git hook 目录”。
后续步骤
如有必要,设置附加参数。
要完成部署,请按照 第 9.1.13 节 “为编写环境完成模板部署” 中的步骤操作。
9.1.8. 为高可用性部署配置资源使用情况
如果要部署高可用性模板(rhpam711-authoring-ha.yaml
),您可以选择性地配置资源使用情况来优化您的要求的性能。
如果要部署单个编写环境模板(rhpam711-authoring.yaml
),请跳过这个过程。
有关调整资源大小的更多信息,请参阅 Red Hat OpenShift Container Platform 3.11 产品文档中的以下部分:
先决条件
- 您启动了模板的配置,如 第 9.1.1 节 “为编写环境启动模板配置” 所述。
流程
将模板的以下参数设置为适用:
-
Business Central Container Memory Limit (
BUSINESS_CENTRAL_MEMORY_LIMIT
): Business Central 容器的 OpenShift 环境中请求的内存量。默认值为8Gi
。 -
Business Central JVM Max Memory Ratio (
BUSINESS_CENTRAL_JAVA_MAX_MEM_RATIO
):用于 Business Central 的 Java 虚拟机的容器内存百分比。剩余的内存用于操作系统。默认值为80
,限制为 80%。 -
Business Central Container CPU limit (
BUSINESS_CENTRAL_CPU_LIMIT
): Business Central 的最大 CPU 用量。默认值为2000m
。 -
KIE Server Container Memory Limit (
KIE_SERVER_MEMORY_LIMIT
): KIE Server 容器的 OpenShift 环境中请求的内存量。默认值为1Gi
。 -
KIE Server Container CPU Limit (
KIE_SERVER_CPU_LIMIT
): KIE 服务器的最大 CPU 使用量。默认值为1000m
。 -
datagrid Container Memory Limit (
DATAGRID_MEMORY_LIMIT
):Red Hat Data Grid 容器的 OpenShift 环境中请求的内存量。默认值为2Gi
。 -
datagrid Container CPU Limit (
DATAGRID_CPU_LIMIT
):Red Hat Data Grid 的最大 CPU 用量。默认值为1000m
。
9.1.9. 为编写环境设置 RH-SSO 身份验证的参数
如果要使用 RH-SSO 身份验证,请在配置模板以部署编写环境时完成以下附加配置。
不要在同一部署中配置 LDAP 身份验证和 RH-SSO 身份验证。
先决条件
- 在 RH-SSO 身份验证系统中创建了 Red Hat Process Automation Manager 的域。
Red Hat Process Automation Manager 的用户名和密码在 RH-SSO 身份验证系统中创建。有关可用角色的列表,请参阅 第 14 章 Red Hat Process Automation Manager 角色和用户。
您必须为管理用户在 secret 中配置的用户名和密码的用户,如 第 7.5 节 “为管理用户创建 secret” 所述。此用户必须具有
kie-server、rest-all、admin
角色。- 客户端在您要部署的 Red Hat Process Automation Manager 环境的所有组件的 RH-SSO 身份验证系统中创建。客户端设置包含组件的 URL。在部署环境后,您可以查看并编辑 URL。另外,Red Hat Process Automation Manager 部署也可以创建客户端。但是,这个选项对环境提供较少的详细控制。
- 您启动了模板的配置,如 第 9.1.1 节 “为编写环境启动模板配置” 所述。
流程
设置以下参数:
-
RH-SSO URL (
SSO_URL
):RH-SSO 的 URL。 -
RH-SSO Realm 名称 (
SSO_REALM
):Red Hat Process Automation Manager 的 RH-SSO 域。 -
RH-SSO 禁用 SSL 证书验证 (
SSO_DISABLE_SSL_CERTIFICATE_VALIDATION
):如果您的 RH-SSO 安装不使用有效的 HTTPS 证书,则设置为true
。
-
RH-SSO URL (
完成以下流程之一:
如果您在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端,请在模板中设置以下参数:
-
Business Central RH-SSO Client name (
BUSINESS_CENTRAL_SSO_CLIENT
): Business Central 的 RH-SSO 客户端名称。 -
Business Central RH-SSO Client Secret (
BUSINESS_CENTRAL_SSO_SECRET
):在 RH-SSO 中为 Business Central 的客户端设置的 secret 字符串。 -
KIE Server RH-SSO Client name (
KIE_SERVER_SSO_CLIENT
): KIE 服务器的 RH-SSO 客户端名称。 -
KIE Server RH-SSO Client Secret (
KIE_SERVER_SSO_SECRET
):为 KIE 服务器的客户端在 RH-SSO 中设置的机密字符串。
-
Business Central RH-SSO Client name (
要在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端,请在模板中设置以下参数:
-
Business Central RH-SSO Client name (
BUSINESS_CENTRAL_SSO_CLIENT
):要在 Business Central 的 RH-SSO 中创建的客户端名称。 -
Business Central RH-SSO Client Secret (
BUSINESS_CENTRAL_SSO_SECRET
):在 RH-SSO 中为 Business Central 的客户端设置的 secret 字符串。 -
KIE Server RH-SSO Client name (
KIE_SERVER_SSO_CLIENT
):要在 KIE 服务器的 RH-SSO 中创建的客户端名称。 -
KIE Server RH-SSO Client Secret (
KIE_SERVER_SSO_SECRET
):为 KIE 服务器的客户端在 RH-SSO 中设置的 secret 字符串。 -
RH-SSO Realm Admin Username (
SSO_USERNAME
)和 RH-SSO Realm Admin Password (SSO_PASSWORD
):Red Hat Process Automation Manager 的 RH-SSO 域的域用户名和密码。您必须提供此用户名和密码才能创建所需的客户端。
-
Business Central RH-SSO Client name (
后续步骤
如有必要,设置附加参数。
要完成部署,请按照 第 9.1.13 节 “为编写环境完成模板部署” 中的步骤操作。
完成部署后,查看 RH-SSO 身份验证系统中 Red Hat Process Automation Manager 组件的 URL,以确保它们正确。
9.1.10. 为编写的环境设置 LDAP 身份验证参数
如果要使用 LDAP 身份验证,请在配置模板来部署编写环境时完成以下附加配置。
不要在同一部署中配置 LDAP 身份验证和 RH-SSO 身份验证。
先决条件
您在 LDAP 系统中为 Red Hat Process Automation Manager 创建用户名和密码。有关可用角色的列表,请参阅 第 14 章 Red Hat Process Automation Manager 角色和用户。
您必须为管理用户在 secret 中配置的用户名和密码的用户,如 第 7.5 节 “为管理用户创建 secret” 所述。此用户必须具有
kie-server、rest-all、admin
角色。- 您启动了模板的配置,如 第 9.1.1 节 “为编写环境启动模板配置” 所述。
流程
设置模板的
AUTH_LDAP
the 参数。这些参数与 Red Hat JBoss EAP 的LdapExtended
Login 模块的设置对应。有关使用这些设置的说明,请参阅 LdapExtended 登录模块。注意如果要启用 LDAP 故障转移,您可以将设置或多个 LDAP 服务器地址放在
AUTH_LDAP_URL
参数中,用空格分开。如果 LDAP 服务器没有定义部署所需的所有角色,您可以将 LDAP 组映射到 Red Hat Process Automation Manager 角色。要启用 LDAP 角色映射,请设置以下参数:
-
RoleMapping rolesProperties 文件路径 (
AUTH_ROLE_MAPPER_ROLES_PROPERTIES
): 定义角色映射的文件的完全限定域名,如/opt/eap/standalone/configuration/rolemapping/rolemapping.properties
。您必须提供此文件并将其挂载到所有适用的部署配置中的该路径中 ; 具体步骤请查看 第 13.3 节 “(可选)提供 LDAP 角色映射文件”。 -
RoleMapping replaceRole 属性 (
AUTH_ROLE_MAPPER_REPLACE_ROLE
):如果设为true
,则映射的角色会替换 LDAP 服务器上定义的角色;如果设为false
,则 LDAP 服务器上定义的映射角色和角色都被设置为用户应用角色。默认设置为false
。
-
RoleMapping rolesProperties 文件路径 (
后续步骤
如有必要,设置附加参数。
要完成部署,请按照 第 9.1.13 节 “为编写环境完成模板部署” 中的步骤操作。
9.1.11. 为编写环境设置使用外部数据库服务器的参数
如果您将模板修改为将外部数据库服务器用于 KIE 服务器,如 第 9.3 节 “修改单个编写环境的模板” 或 第 9.4 节 “修改高可用性编写环境的模板” 所述,请在配置模板以部署编写环境时完成以下附加配置。
先决条件
- 您启动了模板的配置,如 第 9.1.1 节 “为编写环境启动模板配置” 所述。
流程
设置以下参数:
KIE Server External Database Driver (
KIE_SERVER_EXTERNALDB_DRIVER
):服务器的驱动程序,具体取决于服务器类型:-
mysql
-
postgresql
-
mariadb
-
mssql
-
db2
-
oracle
-
法国
-
-
KIE 服务器外部数据库用户 (
KIE_SERVER_EXTERNALDB_USER
)和 KIE 服务器外部数据库密码(KIE_SERVER_EXTERNALDB_PWD
):外部数据库服务器的用户名和密码 KIE Server External Database URL (
KIE_SERVER_EXTERNALDB_URL
):外部数据库服务器的 JDBC URL注意如果您使用 EntrepriseDB Postgres 数据库服务器,请使用以
jdbc:postgresql://
开头的 URL,而不是jdbc:edb://
。或者,不要设置 URL,并设置主机和端口参数。-
KIE 服务器外部数据库主机 (
KIE_SERVER_EXTERNALDB_SERVICE_HOST
)和 KIE 服务器外部数据库端口 (KIE_SERVER_EXTERNALDB_SERVICE_PORT
):外部数据库服务器的主机名和端口号。您可以将这些参数设置为设置KIE_SERVER_EXTERNALDB_URL
参数的替代选择。 KIE Server External Database Dialect (
KIE_SERVER_EXTERNALDB_DIALECT
):服务器的 Hibernate 划分,具体取决于服务器类型。常见设置有:-
org.hibernate.dialect.MySQL5InnoDBDialect
-
org.hibernate.dialect.MySQL8Dialect
-
org.hibernate.dialect.MariaDB102Dialect
-
org.hibernate.dialect.PostgreSQL95Dialect
-
org.hibernate.dialect.PostgresPlusDialect
(用于 EntrepriseDB Postgres Advanced Server) -
org.hibernate.dialect.SQLServer2012Dialect
(used for MS SQL) -
org.hibernate.dialect.DB2Dialect
-
org.hibernate.dialect.Oracle10gDialect
org.hibernate.dialect.SybaseASE15Dialect
有关支持的 dialects 列表,请参阅 Red Hat JBoss EAP 文档中的 Hibernate 属性中的 Hibernate SQL Dialects 表。
-
-
KIE 服务器外部数据库名称 (
KIE_SERVER_EXTERNALDB_DB
):在外部数据库服务器上使用的数据库名称 -
JDBC Connection Checker 类 (
KIE_SERVER_EXTERNALDB_CONNECTION_CHECKER
):数据库服务器的 JDBC 连接检查程序类的名称。如果没有此信息,则数据库服务器连接在丢失后无法恢复,例如如果数据库服务器重启。 -
JDBC Exception Sorter 类 (
KIE_SERVER_EXTERNALDB_EXCEPTION_SORTER
):数据库服务器的 JDBC 异常分类类的名称。如果没有此信息,则数据库服务器连接在丢失后无法恢复,例如如果数据库服务器重启。
如果您为使用外部数据库服务器创建了自定义镜像,如 第 7.10 节 “为外部数据库构建自定义 KIE 服务器扩展镜像” 所述,请设置以下参数:
-
驱动程序扩展镜像 (
EXTENSIONS_IMAGE
):扩展镜像的 ImageStreamTag 定义,如jboss-kie-db2-extension-openshift-image:11.1.4.4
-
Driver ImageStream Namespace (
EXTENSIONS_IMAGE_NAMESPACE
):您将扩展镜像上传到的命名空间,如openshift
或项目命名空间。
-
驱动程序扩展镜像 (
如果您使用 MySQL 版本 8 外部数据库服务器,请启用
mysql_native_password
插件并使用它进行身份验证。有关此诊断的说明,请参阅 MySQL 8.0 参考手册 中的 原生可插拔验证。如果您使用红帽提供的 MySQL 版本 8 镜像在 Red Hat OpenShift Container Platform 上启用插件,请将
MYSQL_DEFAULT_AUTHENTICATION_PLUGIN
环境变量设置为mysql_native_password
。如果您在启用
mysql_native_password
插件前在 MySQL 8 服务器上创建了用户,您必须在启用插件后更新mysql-user
表。
后续步骤
如有必要,设置附加参数。
要完成部署,请按照 第 9.1.13 节 “为编写环境完成模板部署” 中的步骤操作。
9.1.12. 为编写的环境启用 Prometheus 指标集合
如果要将 KIE 服务器部署配置为使用 Prometheus 来收集和存储指标,请在安装时在 KIE 服务器中启用对此功能的支持。
先决条件
- 您启动了模板的配置,如 第 9.1.1 节 “为编写环境启动模板配置” 所述。
流程
要启用对 Prometheus 指标集合的支持,请将 Prometheus Server Extension Disabled (PROMETHEUS_SERVER_EXT_DISABLED
)参数设置为 false
。
后续步骤
如有必要,设置附加参数。
要完成部署,请按照 第 9.1.13 节 “为编写环境完成模板部署” 中的步骤操作。
有关配置 Prometheus 指标集合的说明,请参阅 管理和监控 KIE 服务器。
9.1.13. 为编写环境完成模板部署
在 OpenShift Web UI 或命令行中设置所有必要的参数后,请完成模板部署。
流程
根据您使用的方法,完成以下步骤:
在 OpenShift Web UI 中,单击 Create。
-
如果
这将创建可能具有安全性或项目行为影响的资源
,请单击 Create Anyway。
-
如果
- 完成命令行并按 Enter。
后续步骤
根据您的环境需求,可选完成 第 13 章 部署环境后的可选步骤 中描述的步骤。