在 Red Hat OpenShift Container Platform 上部署 Red Hat Process Automation Manager

流程

1. 在 Red Hat OpenShift Container Platform Web 集群控制台菜单中，选择 Catalog → Installed operators 或 Operators → Installed operator。
2. 点包含 businessautomation 的 operator 名称。此时会显示有关此 Operator 的信息。
3. 点击位于窗口右侧的 安装程序 链接。
4. 若有提示，使用 OpenShift 凭据登录。

流程

1. 在 Application Name 字段中输入 OpenShift 应用的名称。此名称用于所有组件的默认 URL。

2. 在 Environment 列表中，选择环境的类型。这个类型决定了默认配置；您可以根据需要修改此配置。以下类型可用于 Red Hat Process Automation Manager：

   • RHPAM-trial ：您可以快速设置的试用环境，用于评估或演示开发和运行资产。包括 Business Central 和 KIE 服务器.此环境不使用任何持久性存储，并且您在环境中所做的任何工作都不会保存。
   • RHPAM- authoring：使用 Business Central 创建和修改服务的环境.它由为编写工作和 KIE 服务器提供 Business Central 的 pod 组成，用于测试服务的执行。

   • RHPAM-authoring-ha ：使用 Business Central 创建和修改服务的环境。它由为编写工作和 KIE 服务器提供 Business Central 的 pod 组成，用于测试服务的执行。此编写环境版本支持扩展 Business Central pod，以确保高可用性。

     重要

     在 Red Hat Process Automation Manager 7.12 中，使用操作器的高可用性 Business Central 功能部署仅用于技术预览。有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。对于完全支持的高可用性部署，在 Red Hat OpenShift Container Platform 版本 3.11 中使用高可用性的编写模板。有关部署此模板的步骤，请参阅 第 II 部分 “使用模板在 Red Hat OpenShift Container Platform 3 上部署 Red Hat Process Automation Manager 环境”。

   • RHPAM-production ：用于运行现有服务以进行临时和生产目的的环境。此环境包括 Business Central Monitoring、智能路由器和两个 KIE 服务器 pod 组。您可以在每一个这样的组上部署和取消部署服务，并根据需要扩展组。使用 Business Central Monitoring 部署、运行和停止服务并监控其执行。

   • RHPAM-production-immutable ：用于运行现有服务的替代环境，用于暂存和生产目的。您可以配置一个或多个 KIE Server pod，从源构建服务，或者从 Maven 存储库拉取服务。然后，您可以根据需要复制每个 pod。

     您无法从 pod 中删除任何服务，或将任何新服务添加到 pod。如果要使用服务的另一个版本，或者以任何其他方式修改配置，请部署新的服务器镜像来替换旧服务器镜像。您可以使用任何基于容器的集成工作流来管理 pod。

     配置此环境时，在 KIE Servers 选项卡中，您必须自定义 KIE Server，再单击 Set immutable 服务器配置 按钮，或者设置 KIE_SERVER_CONTAINER_DEPLOYMENT 环境变量。有关配置 KIE 服务器的步骤，请参考 第 3.2.5 节 “设置环境的自定义 KIE 服务器配置”。

     另外，您还可以使用 Console 选项卡在此环境中包含 Business Central Monitoring 来监控、停止和重新启动进程服务的执行。有关配置 Business Central Monitoring 的步骤，请参考 第 3.2.4 节 “设置环境的 Business Central 配置”。

3. 如果要启用自动升级到新版本，请选择 Enable Upgrades 复选框。如果选中此框，则在有新的 Red Hat Process Automation Manager 7.12 补丁版本可用时，Operator 会自动将部署升级到此版本。所有服务都会保留，并通常会在升级过程中保留。

   当有新的 Red Hat Process Automation Manager 7.x 次版本可用时，还要启用相同的自动升级过程，请选择 Include 次版本升级 框。

   注意

   如果要对 Red Hat Process Automation Manager 的任何组件使用自定义镜像，则禁用自动更新。

4. 如果要使用镜像标签下载镜像，请选择 Use Image Tags 复选框。如果您使用自定义 registry，或者由红帽支持指示，则此设置很有用。

5. 如果要禁用到部署的 SSL 连接，请选择 Disable SSL Routes 复选框。在这种情况下，外部公开的所有路由都使用明文(HTTP)连接。

   注意

   如果没有选择此框，则只有安全(HTTPS)路由会在外部公开。

6. 如果要使用自定义镜像 registry，在 Custom registry 下，在 Image registry 字段中输入 registry 的 URL。如果此 registry 没有正确签名和可识别的 SSL 证书，请选择 Insecure 框。

   注意

   要使用自定义 registry 中的特定镜像，请在 Console 和 KIE Server 选项卡中设置镜像上下文、名称和标签。

7. 在 Admin user 下，在 Username 和 Password 字段中输入 Red Hat Process Automation Manager 的管理用户的用户名和密码。

   重要

   如果使用 RH-SSO 或 LDAP 身份验证，则必须在使用 Red Hat Process Automation Manager 的 kie-server,rest-all,admin 角色在身份验证系统中配置相同的用户。

8. 可选：选择启动策略。OpenShiftStartupStrategy 设置默认为启用。

   在某些编写环境中，您可能需要确保多个用户可以同时在同一 KIE 服务器上部署服务。默认情况下，在使用 Business Central 将服务部署到 KIE 服务器后，用户必须等待几秒钟才能部署更多服务。OpenShiftStartupStrategy 设置默认为启用，并导致这个限制。要删除限制，请从 Startup Strategy 列表中选择 ControllerBasedStartupStrategy 设置。

   注意

   不要在具有高可用性的 Business Central 的环境中启用基于控制器的启动策略。

9. 可选： 如果要使用 OpenShift CA 捆绑包作为 HTTPS 通信的信任存储，请选择 Use OpenShift CA Bundle 复选框。

流程

1. 如果打开了 Installation 选项卡，点 Next 查看 Security 选项卡。

2. 在 Authentication mode 列表中，选择以下模式之一：

   • 内部 ：您可以在部署环境时配置初始管理用户。您可以创建一个 post-configuration 脚本来在 Elytron 安全子系统中添加用户。有关创建安装后脚本的步骤，请参考 第 3.4 节 “提供 Elytron 用户配置或其他安装后设置”。
   • RH-SSO ：红帽流程自动化管理器使用红帽单点登录进行身份验证。
   • LDAP ：红帽流程自动化管理器使用 LDAP 进行身份验证

3. 根据您选择的 Authentication 模式 完成安全配置。

   如果选择了 RH-SSO，请配置 RH-SSO 身份验证：

   1. 在 RH-SSO URL 字段中，输入 RH-SSO URL。
   2. 在 Realm 字段中，输入 RH-SSO 域名。
   3. 如果没有为环境组件创建 RH-SSO 客户端，请在 SSO admin 用户和 SSO admin 密码字段中输入 RH-SSO 系统 的管理员用户 凭据。
   4. 如果您的 RH-SSO 系统没有正确的签名 SSL 证书，请选择 Disable SSL certificate validation 复选框。
   5. 如果要更改用于用户名的 RH-SSO 主体属性，在 Principal 属性 字段中输入新属性的名称。

   如果选择了 LDAP，请配置 LDAP 身份验证：

   1. 在 LDAP URL 字段中，输入 LDAP URL。

   2. 设置 LDAP 参数。这些参数使用红帽 JBoss EAP 的 Elytron 子系统配置 LDAP 身份验证。有关在 LDAP 中使用 Red Hat JBoss EAP 的 Elytron 子系统的更多信息，请参阅使用 基于 LDAP 的身份存储配置身份验证。

      注意

      如果要启用 LDAP 故障转移，您可以在 AUTH_LDAP_URL 参数中设置两个或多个 LDAP 服务器地址，用空格分隔。

4. 如果选择了 RH-SSO 或 LDAP，如果您的 RH-SSO 或 LDAP 系统没有定义部署所需的所有角色，您可以将身份验证系统角色映射到 Red Hat Process Automation Manager 角色。

   要启用角色映射，您必须以单一配置字符串或角色映射形式提供角色映射。如果使用文件进行角色映射配置，则必须在项目命名空间中的 OpenShift 配置映射或机密对象中提供该文件。

   字符串必须使用 role=role1,role2;another-role=role2 模式，如 admins=kie-server,rest-all,admin;developers=kie-server,rest-all。

   该文件必须包含以下格式的条目：

   ldap_role=product_role1, product_role2...

   例如：

   admins=kie-server,rest-all,admin

   要启用这个字符串或文件，请进行以下更改：

   1. 在 RoleMapper 下，在 Roles properties file 字段中输入角色配置字符串或角色映射配置文件的完全限定路径名称，如 /opt/eap/standalone/configuration/rolemapping/rolemapping.properties。
   2. 可选： 选择 Roles keep mapped 框或 Roles 保留非映射 框。如果您定义角色映射，默认情况下，只有映射中定义的角色可用。如果要保留身份验证系统中定义的原始角色，并且映射映射到其他角色，请选择 Roles keep mapped 框。如果要保留身份验证系统中定义的原始角色，且未在映射中提及，请选择 角色会保留非映射 框。

   3. 如果使用角色配置文件，请在 RoleMapper Configuration 对象 下配置字段：

      • 在 Kind 标签下，选择提供文件的对象类型(ConfigMap 或 Secret)。
      • 在 Name 字段中输入对象名称。此对象自动挂载到您为角色映射配置文件指定的路径中的 Business Central 和 KIE Server pod。

5. 如果需要，配置其他密码：

   • AMQ 密码和 AMQ 集群密码是 使用 JMS API 与 ActiveMQ 交互的密码。
   • keystore password 是 secret 中用于 HTTPS 通信的密钥存储文件的密码。如果您根据 第 2.2 节 “为 KIE 服务器创建 secret” 或 第 2.3 节 “为 Business Central 创建 secret” 中的说明创建了 secret，则设置这个密码。
   • 数据库密码 是作为环境一部分的数据库服务器 pod 的密码。

流程

1. 如果打开了 Installation 或 Security 选项卡，请单击 Next，直到您查看 Console 选项卡。
2. 如果您根据 第 2.3 节 “为 Business Central 创建 secret” 中的说明为 Business Central 创建 secret，请在 Keystore secret 字段中输入 secret 的名称。

3. 可选： 如果要为 Business Central 部署使用自定义镜像，请完成以下步骤：

   1. 在 Installation 选项卡中设置自定义 registry。如果没有设置自定义 registry，安装会使用默认的 Red Hat registry。有关设置自定义 registry 值的更多信息，请参阅 第 3.2.2 节 “设置环境的基本配置”。

   2. 在 Console 选项卡中，设置以下字段：

      • 镜像上下文 ：注册表中镜像的上下文。
      • Image ：镜像的名称。

      • 镜像标签 ：镜像标签。如果没有设置此字段，安装将使用 latest 标签。

        例如，如果镜像的完整地址为 registry.example.com/mycontext/mycentral:1.0-SNAPSHOT，将自定义 registry 设置为 registry.example.com，Image context 字段设为 mycontext，Image 字段为 mycentral，Image tag 字段为 1.0-SPSHOT。

4. 可选： 要为外部路由设置自定义主机名，请在 Business Central 外部 Route 字段中输入要使用的域，如下例所示：

   `businesscentral.example.com`

   注意

   自定义主机名必须有效并可解析。

   要更改自定义主机名，您可以修改 routeHostname 属性。

5. 可选：配置 Git hook。

   在编写环境中，您可以使用 Git hook 来简化 Business Central 的内部 Git 存储库和外部 Git 存储库之间的交互。如果要使用 Git hook，您必须在项目命名空间中的 OpenShift 配置映射、secret 或持久性卷声明对象中准备 Git hook 目录。您还可以使用 SSH 密钥和已知主机文件准备 secret，以进行 Git SSH 身份验证。有关准备 Git hook 的说明，请参阅 第 2.7 节 “准备 Git hook”。

   要使用 Git hook 目录，请进行以下更改：

   1. 在 GitHooks 下，在 Mount path 字段中输入该目录的完全限定路径，例如 /opt/kie/data/git/hooks。
   2. 在 GitHooks Configuration 对象 下的字段 中，选择提供文件(ConfigMap、Secret 或 PersistentVolumeClaim)的对象 Kind，并输入对象的 Name。此对象自动挂载到您为 Git hook 目录指定的路径中的 Business Central pod。
   3. 可选：在 SSH secret 字段中，使用 SSH 密钥和已知主机文件输入 secret 的名称。
6. 可选：在 Replicas 字段中输入 Business Central 监控的副本数。不要在 rhpam-authoring 环境中更改这个数字。
7. 可选： 要在 Console 组件 页面中设置 Business Central 持久性卷大小 pvSize，请在 Persistent Volume Size 字段中输入所需的大小。对于 Business Central，默认大小为 1Gi，用于 Business Central Monitoring ( Business Central Monitoring)为 64Mb。
8. 可选：在 资源配额 下的字段中输入请求和最大 CPU 和内存限值。
9. 如果要在 Business Central pod 上自定义 Java 虚拟机的配置，请选择 Enable JVM 配置 框，然后在 Enable JVM 配置 下的任意字段中输入信息。所有字段都是可选的。有关您可以配置的 JVM 参数，请参阅 第 3.5 节 “JVM 配置参数”。

10. 如果您选择了 RH-SSO 身份验证，请为 Business Central 配置 RH-SSO：

    1. 在 Client name 字段中输入客户端名称，在 Client secret 字段中输入 client secret。如果具有此名称的客户端不存在，部署将尝试使用此名称和 secret 创建新客户端。
    2. 如果部署要创建新客户端，请输入 HTTP 和 HTTPS URL，它们将用于访问 Business Central 到 SSO HTTP URL 和 SSO HTTPS URL 字段。此信息记录在客户端中。
11. 可选： 如果要配置高可用性环境，请在 DataGrid username 和 DataGrid 密码字段中为 DataGrid 组件设置 用户名和密码。默认情况下，用户名是 infinispan，密码会自动生成。

12. 可选： 根据您的需要，设置环境变量。要设置环境变量，请单击 Add new Environment 变量，然后在 Name 和 Value 字段中输入变量的名称和值。

    • 在 rhpam-production 或 rhpam-production-immutable 环境中，如果您希望 Business Central Monitoring 在不使用文件系统的简单模式下运行，请将 ORG_APPFORMER_SIMPLIFIED_MONITORING_ENABLED 设置为 true。

      在简化的模式中，Business Central Monitoring 不需要持久性卷声明。您可以在不支持 ReadWriteMany 访问持久性存储的环境中使用此模式。您不能在简化的模式中使用 Business Central Monitoring 来设计自定义仪表板。

    • 可选：如果要配置代理设置，请使用以下环境变量：

      • HTTPS_ PROXY ： https 代理的位置。这优先于 HTTPS_PROXY、http_proxy 和 HTTP_PROXY，用于 Maven 构建和 Java 运行时。例如： myuser:mypass@127.0.0.1:8080.
      • HTTPS_PROXY ： https 代理的位置。这优先于 http_proxy 和 HTTP_PROXY，用于 Maven 构建和 Java 运行时。例如： myuser@127.0.0.1:8080.
      • HTTP_ PROXY ：http 代理的位置。这优先于 HTTP_PROXY，用于 Maven 构建和 Java 运行时。例如： http://127.0.0.1:8080。
      • HTTP_PROXY ：http 代理的位置。这同时用于 Maven 构建和 Java 运行时。例如： 127.0.0.1:8080.
      • NO_ PROXY ：可以直接访问的以逗号分隔的主机、IP 地址或域的列表。这优先于 NO_PROXY，用于 Maven 构建和 Java 运行时。例如：*.example.com。
      • NO_PROXY ：可以直接访问的以逗号分隔的主机、IP 地址或域的列表。这同时用于 Maven 构建和 Java 运行时。例如： foo.example.com,bar.example.com。

    • 如果要使用外部 Maven 存储库，请设置以下变量：

      • MAVEN_REPO_URL: Maven 存储库的 URL
      • MAVEN_REPO_ID: Maven 存储库的标识符，如 repo-custom
      • MAVEN_REPO_USERNAME: Maven 存储库的用户名

      • MAVEN_REPO_PASSWORD 用于 Maven 存储库的密码

        重要

        在编写环境中，如果您希望 Business Central 将项目推送到外部 Maven 存储库，您必须在部署期间配置此存储库，并且配置每个项目中的存储库。有关将 Business Central 项目导出到外部 Maven 存储库的详情，请参考 打包和部署红帽流程自动化管理器项目。

    • 如果您的 OpenShift 环境没有连接到公共互联网，请配置对根据 第 2.11 节 “准备 Maven 镜像存储库以供离线使用” 设置的 Maven 镜像的访问。设置以下变量：

      • MAVEN_MIRROR_URL: 您在 第 2.11 节 “准备 Maven 镜像存储库以供离线使用” 中设置的 Maven 镜像存储库的 URL。此 URL 必须从 OpenShift 环境中的容器集访问。

      • MAVEN_MIRROR_OF ：决定可以从镜像检索哪些工件的值。有关设置 mirrorOf 值的说明，请参阅 Apache Maven 文档中的 Mirror Settings。默认值为 external:*。使用此值，Maven 从镜像检索每个所需的工件，且不会查询任何其他存储库。

        如果您配置外部 Maven 存储库(MAVEN_REPO_URL)，请更改 MAVEN_MIRROR_OF，以从镜像中排除此仓库中的工件，如 external:*,!repo-custom。将 repo-custom 替换为您在 MAVEN_REPO_ID 中配置的 ID。

        如果您的编写环境使用内置的 Business Central Maven 存储库，请更改 MAVEN_MIRROR_OF，将该存储库中的工件从镜像中排除： external:*,!repo-rhpamcentr。

    • 在某些情况下，您可能想要为 Business Central 持久保留 Maven 存储库缓存。默认情况下，缓存不会被保留，因此在重启或扩展 Business Central pod 时，所有 Maven 工件都会再次下载，且 Business Central 中的所有项目都必须再次构建。如果您为缓存启用持久性，则不需要下载，在某些情况下可以改进启动时间。但是，需要具有 Business Central persistence 卷上的大量额外空间。

      要为 Maven 存储库缓存启用持久性，请将 KIE_PERSIST_MAVEN_REPO 环境变量设置为 true。

      如果将 KIE_PERSIST_MAVEN_REPO 设置为 true，您可以选择使用 KIE_M2_REPO_DIR 变量为缓存设置自定义路径。默认路径为 /opt/kie/data/m2。/opt/kie/data 目录树中的文件是永久的。

流程

1. 如果打开了 安装、安全 或 控制台选项卡，请单击 Next，直到您查看 KIE Servers 选项卡。
2. 单击 Add new KIE Server 以添加新的 KIE 服务器配置。
3. 在 Id 字段中输入此 KIE 服务器实例的标识符。如果 KIE 服务器实例连接到 Business Central 或 Business Central Monitoring 实例，该标识符决定服务器加入的服务器组。
4. 在 Name 字段中输入 KIE Server 的名称。
5. 在 Deployments 字段中，输入要部署的类似 KIE Servers 的数量。安装程序可以使用相同的配置部署多个 KIE 服务器。KIE 服务器的标识符和名称会自动修改，并保持唯一性。
6. 如果您根据 第 2.2 节 “为 KIE 服务器创建 secret” 中的说明为 KIE Server 创建 secret，请在 Keystore secret 字段中输入 secret 的名称。
7. 可选：在 Replicas 字段中输入 KIE 服务器部署的副本数量。

8. 可选： 要为外部路由设置自定义主机名，请在 KIE Server external Route 字段中输入自定义主机名中使用的 域，如下例所示：

   `kieserver.example.com`

   注意

   自定义主机名必须有效并可解析。

   要更改自定义主机名，您可以修改 routeHostname 属性。

9. 可选： 如果要使用自定义 KIE 服务器镜像，请完成以下步骤：

   1. 单击 Set KIE Server 镜像。

   2. 在 Kind 类别中，选择 ImageStreamTag（如果要从 OpenShift 镜像流中拉取镜像），或者选择 DockerImage （如果要从任何 Docker registry 拉取镜像）。

      注意

      要使用 DockerImage kind，您必须使用 Red Hat Process Automation Manager 版本 7.12.1 或更高版本。

   3. 通过完成以下步骤之一设置镜像名称：

      • 如果选择了 ImageStreamTag kind，请在 Name 字段中输入镜像的镜像流标签名称，如 my-custom-is-tag:1.0。

        如果环境中不存在对应的镜像流，Operator 会使用默认的 Red Hat registry 和标签创建此镜像流。如果在 Installation 选项卡中配置了自定义 registry，Operator 会使用此 registry 创建镜像流。

      • 如果选择了 DockerImage kind，请在 Name 字段中输入镜像的完全限定域名，如 registry.io/test/testing:1.0。

        您可以从环境可访问的任何 registry 配置镜像。

   4. 如果要使用不在 openshift 命名空间中的镜像流，在 Namespace 字段中输入命名空间。

      有关创建自定义镜像的步骤，请参阅 第 3.6 节 “为 KIE 服务器和智能路由器创建自定义镜像”。

10. 可选：如果要使用 Source to Image (S2I)构建来配置不可变 KIE 服务器，请完成以下步骤：

    重要

    如果要配置一个从 Maven 存储库拉取服务的不可变 KIE 服务器，请不要点击 Set Immutable 服务器配置，且不完成这些步骤。相反，设置 KIE_SERVER_CONTAINER_DEPLOYMENT 环境变量。

    1. 点 Set Immutable server configuration。
    2. 在 KIE Server 容器部署字段中，输入部署 必须从 Source 到 Image (S2I)构建的结果中提取的服务(KJAR 文件)的识别信息。格式为 <containerId>=<groupId>:<artifactId>:<version>，或如果您要为容器设置一个别名，则为<containerId>(<aliasId>)=<groupId>:<artifactId>:<version>。您可以使用 | 分隔符提供两个或多个 KJAR 文件，如下例所示： containerId=groupId:artifactId:version|c2 (alias2)=g2:a2:v2。
    3. 如果您的 OpenShift 环境没有与公共互联网的连接，请在 Maven mirror URL 字段中输入您设置为 第 2.11 节 “准备 Maven 镜像存储库以供离线使用” 的 Maven 镜像的 URL。
    4. 在 Artifact 目录 字段中，在 Maven 构建成功后，输入包含所需二进制文件(KJAR 文件和任何其他必要文件)的项目内的路径。通常，此目录是构建的目标目录。但是，您可以在 Git 存储库中的这个目录中提供预构建二进制文件。
    5. 如果要将自定义基础 KIE Server 镜像用于 S2I 构建，请单击 Set Base build image，然后在 Name 字段中输入镜像流的名称。如果镜像流不在 openshift 命名空间中，在 Namespace 字段中输入命名空间。如果要使用 Docker 镜像名称而不是 OpenShift 镜像流标签，请将 Kind 值改为 DockerImage。

    6. 点 Set Git source，在以下字段中输入信息：

       • S2I Git URI ：包含服务源的 Git 存储库的 URI。
       • 参考 ：Git 存储库中的分支。

       • 上下文目录 ：（可选）从 Git 存储库下载的项目中源的路径。默认情况下，下载的项目的根目录是源目录。

         注意

         如果没有配置 Git 源，则不可变 KIE 服务器不使用 S2I 构建。相反，它会从配置的 Maven 存储库拉取您在 KIE Server 容器部署 字段中定义的工件。

    7. 如果您使用 S2I，并希望设置 Git Webhook，以便 Git 存储库中的更改会导致自动重建 KIE 服务器，点 Add new Webhook。然后在 Type 字段中选择 Webhook 类型，然后在 Secret 字段中输入 Webhook 的 secret 字符串。
    8. 如果要为 S2I 构建设置构建环境变量，请单击 Add new Build Config Environment 变量，然后在 Name 和 Value 字段中输入变量的名称和值。
11. 可选：在 资源配额 下的字段中输入请求和最大 CPU 和内存限值。如果您要配置多个 KIE 服务器，则限制会单独应用于每台服务器。

12. 如果选择了 RH-SSO 身份验证，请为 KIE 服务器配置 RH-SSO：

    1. 在 Client name 字段中输入客户端名称，在 Client secret 字段中输入 client secret。如果具有此名称的客户端不存在，部署将尝试使用此名称和 secret 创建新客户端。
    2. 如果部署要创建新客户端，请输入将用于访问此 KIE 服务器实例的 HTTP 和 HTTPS URL 进入 SSO HTTP URL 和 SSO HTTPS URL 字段。此信息记录在客户端中。

13. 如果要使用外部 AMQ 消息代理通过 JMS API 与 KIE 服务器交互，请启用 Enable JMS Integration 设置。此时会显示用于配置 JMS Integration 的其他字段，您必须根据需要输入值：

    • User name, Password: 如果您的环境需要在代理中进行身份验证，标志代理用户的用户名和密码。
    • executor ：选择此设置来禁用 JMS executor。默认情况下启用 executor。
    • 执行程序处理器 ：选择此设置以在 executor 队列中启用 JMS 事务。
    • 启用信号 ：选择此设置，以启用通过 JMS 进行信号配置。
    • 启用审计 ：选择此设置，以启用通过 JMS 进行审计日志记录。
    • 审计转换 ：选择此设置，以在审计队列上启用 JMS 事务。
    • Queue executor、队列请求、队列响应、队列信号、队列审计 ：要使用的队列的自定义 JNDI 名称。如果设置了任何这些值，还必须设置 AMQ 队列 参数。
    • AMQ Queues ：AMQ 队列名称，用逗号分开。这些队列会在代理启动时自动创建，并可作为 JBoss EAP 服务器中的 JNDI 资源访问。如果使用任何自定义队列名称，则必须在此字段中输入服务器使用的所有队列的名称。
    • 启用 SSL 集成 ：如果要使用到 AMQ 代理的 SSL 连接，请选择此设置。在这种情况下，您必须提供您在 第 2.4 节 “为 AMQ 代理连接创建 secret” 中创建的 secret 名称，以及用于 secret 的密钥存储和信任存储的名称。
14. 如果要在 KIE Server pod 上自定义 Java 虚拟机的配置，请选择 Enable JVM 配置 框，然后在 Enable JVM 配置 下的任何字段中输入信息。所有字段都是可选的。有关您可以配置的 JVM 参数，请参阅 第 3.5 节 “JVM 配置参数”。

15. 在 Database type 字段中，选择 KIE Server 必须使用的数据库。可用的值如下：

    • MySQL ：在独立 pod 中创建的 MySQL 服务器。
    • PostgreSQL ：在独立 pod 中创建的 PostgreSQL 服务器。除非有特定原因使用任何其他设置，否则请使用此设置。
    • h2 ：不需要单独 pod 的内置 h2 数据库引擎。如果使用此设置，请不要扩展 KIE Server pod。
    • 外部 ：外部数据库服务器。

16. 如果您选择了除 外部 之外的任何数据库，则会创建一个持久性卷声明来存储数据库。另外，还可为持久性卷设置配置参数：

    • 在 Size 字段中输入持久性卷的大小。
    • 在 StorageClass name 字段中，为持久性卷输入存储类名称。

17. 可选：如果您选择了 外部数据库，请配置 KIE Server 扩展镜像。如果要使用除 PostgreSQL、MySQL 或 MariaDB 以外的任何数据库服务器，您必须根据 第 2.6 节 “为外部数据库构建自定义 KIE 服务器扩展镜像” 中的说明为数据库服务器驱动程序提供一个 KIE Server 扩展镜像。要将 KIE 服务器配置为使用此扩展镜像，请进行以下更改：

    1. 选择 Enable extension 镜像流 框。
    2. 在 Extension 镜像流标签 字段中，输入您创建的镜像的 ImageStreamTag 定义，例如 jboss-kie-db2-extension-openshift-image:11.1.4.4
    3. 可选： 在 Extension image stream namespace 字段中，输入您将镜像推送到的命名空间。如果没有在此字段中输入任何值，Operator 预期镜像位于 openshift 命名空间中。
    4. 可选： 在 Extension image install directory 字段中，输入扩展所在 extensions 镜像中的目录。如果您使用 第 2.6 节 “为外部数据库构建自定义 KIE 服务器扩展镜像” 中的步骤构建镜像，请不要为此字段输入任何值。

18. 如果您选择了一个外部数据库服务器，请在附加字段中提供以下信息：

    1. driver ：输入数据库服务器驱动程序，具体取决于服务器类型：

       • mysql
       • postgresql
       • mariadb
       • mssql
       • db2
       • oracle
       • sisu

    2. 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 （用于 MS SQL）
       • org.hibernate.dialect.DB2Dialect
       • org.hibernate.dialect.Oracle10gDialect

       • org.hibernate.dialect.SybaseASE15Dialect

         有关支持的 dialects 列表，请参阅 Red Hat JBoss EAP 文档中的 Hibernate 属性中的 Hibernate SQL Dialects 表。

    3. 主机 ：输入外部数据库服务器的主机名。
    4. 端口 ：输入外部数据库服务器的端口号。

    5. JDBC URL ：输入外部数据库服务器的 JDBC URL。

       注意

       如果您使用 EntrepriseDB Postgres 数据库服务器，请使用以 jdbc:postgresql:// 开头的 URL，而不使用 jdbc:edb://。或者，不要设置 URL，而是设置主机和端口参数。

    6. NonXA ：如果您要在非 XA 模式中配置数据源，请选择此框。
    7. JNDI name ：输入应用用于数据源的 JNDI 名称。
    8. 用户名和密码 ： 输入外部数据库服务器的用户名和密码。
    9. 后台验证 ：（可选）选择此框来启用后台 SQL 验证，并输入后台验证间隔。
    10. 可选：为数据库服务器设置最小和最大连接池大小、有效连接检查器类和异常分类器类。

19. 如果您使用 MySQL 版本 8 外部数据库服务器，请启用 mysql_native_password 插件并使用它来进行身份验证。有关此插件的说明，请参阅 MySQL 8.0 Reference Manual 中的 原生可插拔身份验证。

    如果您在 Red Hat OpenShift Container Platform 上使用红帽提供的 MySQL 版本 8 镜像来启用该插件，请将 MYSQL_DEFAULT_AUTHENTICATION_PLUGIN 环境变量设置为 mysql_native_password。

    如果在启用 mysql_native_password 插件前在 MySQL 版本 8 服务器上创建用户，则必须在启用插件后更新 mysql-user 表。

20. 可选：如果要配置代理设置，请使用以下环境变量：

    • HTTPS_ PROXY ： https 代理的位置。这优先于 HTTPS_PROXY、http_proxy 和 HTTP_PROXY，用于 Maven 构建和 Java 运行时。例如： myuser:mypass@127.0.0.1:8080.
    • HTTPS_PROXY ： https 代理的位置。这优先于 http_proxy 和 HTTP_PROXY，用于 Maven 构建和 Java 运行时。例如： myuser@127.0.0.1:8080.
    • HTTP_ PROXY ：http 代理的位置。这优先于 HTTP_PROXY，用于 Maven 构建和 Java 运行时。例如： http://127.0.0.1:8080。
    • HTTP_PROXY ：http 代理的位置。这同时用于 Maven 构建和 Java 运行时。例如： 127.0.0.1:8080.
    • NO_ PROXY ：可以直接访问的以逗号分隔的主机、IP 地址或域的列表。这优先于 NO_PROXY，用于 Maven 构建和 Java 运行时。例如：*.example.com。
    • NO_PROXY ：可以直接访问的以逗号分隔的主机、IP 地址或域的列表。这同时用于 Maven 构建和 Java 运行时。例如： foo.example.com,bar.example.com。

21. 可选： 根据您的需要，设置环境变量。要设置环境变量，请单击 Add new Environment 变量，然后在 Name 和 Value 字段中输入变量的名称和值。

    • 如果要配置从配置的 Maven 存储库拉取服务的不可变 KIE 服务器，请输入以下设置：

      1. 设置 KIE_SERVER_CONTAINER_DEPLOYMENT 环境变量。变量必须包含部署必须从 Maven 存储库拉取的服务(KJAR 文件)的识别信息。格式为 <containerId>=<groupId>:<artifactId>:<version>，或如果您要为容器设置一个别名，则为<containerId>(<aliasId>)=<groupId>:<artifactId>:<version>。您可以使用 | 分隔符提供两个或多个 KJAR 文件，如下例所示： containerId=groupId:artifactId:version|c2 (alias2)=g2:a2:v2。
      2. 配置外部 Maven 存储库。

    • 如果要配置外部 Maven 存储库，请设置以下变量：

      • MAVEN_REPO_URL: Maven 存储库的 URL
      • MAVEN_REPO_ID: Maven 存储库的标识符，如 repo-custom
      • MAVEN_REPO_USERNAME: Maven 存储库的用户名
      • MAVEN_REPO_PASSWORD: Maven 存储库的密码

    • 如果您的 OpenShift 环境没有连接到公共互联网，请配置对根据 第 2.11 节 “准备 Maven 镜像存储库以供离线使用” 设置的 Maven 镜像的访问。设置以下变量：

      • MAVEN_MIRROR_URL: 您在 第 2.11 节 “准备 Maven 镜像存储库以供离线使用” 中设置的 Maven 镜像存储库的 URL。此 URL 必须从 OpenShift 环境中的容器集访问。如果您将此 KIE 服务器配置为 S2I，您已输入了这个 URL。

      • MAVEN_MIRROR_OF ：决定可以从镜像检索哪些工件的值。如果您将此 KIE 服务器配置为 S2I，请不要设置这个值。有关设置 mirrorOf 值的说明，请参阅 Apache Maven 文档中的 Mirror Settings。默认值为 external:*。使用此值，Maven 从镜像检索每个所需的工件，且不会查询任何其他存储库。

        如果您配置外部 Maven 存储库(MAVEN_REPO_URL)，请更改 MAVEN_MIRROR_OF，以从镜像中排除此仓库中的工件，如 external:*,!repo-custom。将 repo-custom 替换为您在 MAVEN_REPO_ID 中配置的 ID。

        如果您的编写环境使用内置的 Business Central Maven 存储库，请更改 MAVEN_MIRROR_OF，将该存储库中的工件从镜像中排除： external:*,!repo-rhpamcentr。

    • 如果要将 KIE Server 部署配置为使用 Prometheus 来收集和存储指标，请将 PROMETHEUS_SERVER_EXT_DISABLED 环境变量设置为 false。有关配置 Prometheus 指标集合的说明，请参阅 管理和监控 KIE Server。

    • 如果您使用 Red Hat Single Sign-On 身份验证，并且应用程序与红帽单点登录的交互需要支持跨原始资源共享(CORS)，请配置 CORS 过滤器配置 ：

      • 要使用带有默认设置的 CORS，请确保从 CORS Filters configuration 类别中选择 Default configuration，然后选择 Enable CORS with Default values。
      • 要使用自定义配置的 CORS，从 CORS Filters configuration 列表中选择 Custom configuration，并为 CORS 过滤器输入相关值。

流程

1. 如果打开了 Installation, Security, Console, 或 KIE Servers 标签页，点 Next 直到您看到 Smart Router 标签页。
2. 单击 Set Smart Router，将智能路由器添加到环境中并配置智能路由器。

3. 如果您根据 第 3.6.3 节 “使用额外 JAR 文件创建自定义智能路由器镜像，以实施自定义路由” 中的说明创建了自定义智能路由器镜像，请设置以下值：

   • 镜像构建器 ：项目名称，如 rhpam-project

   • Image ：自定义镜像名称，如 rhpam-smartrouter-rhel8-custom

     如果您为镜像使用自定义标签，请将 Image tag 字段设置为此标签。

4. 如果您根据 第 2.5 节 “为智能路由器创建 secret” 中的说明为 Smart Router 创建 secret，请在 Secret 字段中输入 secret 的名称。
5. 可选：在 Replicas 字段中输入智能路由器的副本数。

6. 可选： 要为外部路由设置自定义主机名，请在 Smart Router external Route 字段中输入自定义主机名中使用的 域，如下例所示：

   `smartrouter.example.com`

   注意

   自定义主机名必须有效并可解析。

   要更改自定义主机名，您可以修改 routeHostname 属性。

7. 可选：在 资源配额 下的字段中输入请求和最大 CPU 和内存限值。

8. 可选：使用环境变量设置日志级别：

   1. 单击 Add new Environment 变量。
   2. 在 Name 字段中输入 LOG_LEVEL。
   3. 在 Value 字段中输入 Java 日志级别。有关可用日志级别的列表，请参阅类级别。

   4. 可选：按软件包名称为组件设置不同的日志记录级别：

      1. 单击 Add new Environment 变量。
      2. 在 Name 字段中输入 LOG_LEVEL。

      3. 在 Value 字段中输入软件包和日志记录级别，如下例所示：

         com.example.abc=FINEST,com.example.def=SEVERE,com.example.xyz=FINE

流程

1. 如果打开 Installation, Security, Console, KIE Servers, 或 Smart Router tab is 标签页，点 Next 直到您看到 Process Instance Migration 标签页。
2. 点 Set Process Instance Migration 将 PIM 添加到环境中并配置 PIM。

3. 在 Database type 字段中，选择 PIM 服务必须使用的数据库。可用的值如下：

   • MySQL ：在独立 pod 中创建的 MySQL 服务器。
   • PostgreSQL ：在独立 pod 中创建的 PostgreSQL 服务器。除非有特定原因使用任何其他设置，否则请使用此设置。
   • h2 ：不需要单独 pod 的内置 h2 数据库引擎。

4. 可选：为数据库设置持久性卷的配置参数：

   • 在 Size 字段中输入持久性卷的大小
   • 在 StorageClass name 字段中，为持久性卷输入存储类名称

流程

1. 使用 podman login 命令向 registry.redhat.io registry 进行身份验证。有关向 registry 进行身份验证的说明，请参阅 Red Hat Container Registry 身份验证。

2. 要下载支持的 KIE 服务器基础镜像，请输入以下命令：

   podman pull registry.redhat.io/rhpam-7/rhpam-kieserver-rhel8:7.12.0

3. 创建一个 Dockerfile，以基于基础镜像定义自定义镜像。该文件必须将当前用户更改为 root，使用 yum 命令安装 RPM 软件包，然后恢复到 USER 185 （红帽 JBoss EAP 用户）。以下示例显示了 Dockerfile 文件的内容：

   FROM registry.redhat.io/rhpam-7/rhpam-kieserver-rhel8:7.12.0
   USER root
   RUN yum -y install procps-ng
   USER 185

   根据需要替换 RPM 文件的名称。yum 命令从 Red Hat Enterprise Linux 8 软件仓库自动安装所有依赖项。在这种情况下，您可能需要安装多个 RPM 文件，请使用几个 RUN 命令。

4. 使用 Dockerfile 构建自定义镜像。提供镜像的完全限定名称，包括 registry 名称。您必须使用与基础镜像版本相同的 version 标签。要构建镜像，请输入以下命令：

   podman build . --tag registry_address/image_name:7.12.0

   例如：

   podman build . --tag registry.example.com/custom/rhpam-kieserver-rhel8:7.12.0

5. 构建完成后，运行镜像，登录镜像，并验证自定义是否成功。使用以下命令：

   podman run -it --rm registry_address/image_name:7.12.0 /bin/bash

   例如：

   podman run -it --rm registry.example.com/custom/rhpam-kieserver-rhel8:7.12.0 /bin/bash

   在镜像的 shell 提示符中，输入命令来测试 RPM 是否已安装，然后输入 exit。例如，对于 procps-ng，请运行 ps 命令：

   [jboss@c2fab36b778e ~]$ ps
   PID TTY          TIME CMD
     1 pts/0    00:00:00 bash
    13 pts/0    00:00:00 ps
   [jboss@c2fab36b778e ~]$ exit

6. 要将自定义镜像推送到 registry 中，请输入以下命令：

   podman push registry_address/image_name:7.12.0 docker://registry_address/image_name:7.12.0

   例如：

   podman push registry.example.com/custom/rhpam-kieserver-rhel8:7.12.0 docker://registry.example.com/custom/rhpam-kieserver-rhel8:7.12.0

流程

1. 开发与 KIE 服务器一起使用的自定义库。您可以使用以下文档和示例来开发库：

   • 管理和监控 KIE Server 中的 KIE Server 能力和扩展。
   • Red Hat Process Automation Manager 和 Decision Manager 提供特定于域的 Prometheus 指标
   • 使用其他传输扩展 KIE 服务器
2. 使用 Maven 构建库，以便 JAR 文件放置在 目标目录中。本例使用 custom-kieserver-ext-1.0.0.Final.jar 文件名。
3. 使用 podman login 命令向 registry.redhat.io registry 进行身份验证。有关向 registry 进行身份验证的说明，请参阅 Red Hat Container Registry 身份验证。

4. 要下载支持的 KIE 服务器基础镜像，请输入以下命令：

   podman pull registry.redhat.io/rhpam-7/rhpam-kieserver-rhel8:7.12.0

5. 创建一个 Dockerfile，以基于基础镜像定义自定义镜像。该文件必须将 JAR 文件（或多个 JAR 文件）复制到 /opt/eap/standalone/deployments/ROOT.war/WEB-INF/lib/ 目录中。以下示例显示了 Dockerfile 文件的内容：

   FROM registry.redhat.io/rhpam-7/rhpam-kieserver-rhel8:7.12.0
   COPY target/custom-kieserver-ext-1.0.0.Final.jar /opt/eap/standalone/deployments/ROOT.war/WEB-INF/lib/

6. 使用 Dockerfile 构建自定义镜像。提供镜像的完全限定名称，包括 registry 名称。您必须使用与基础镜像版本相同的 version 标签。要构建镜像，请输入以下命令：

   podman build . --tag registry_address/image_name:7.12.0

   例如：

   podman build . --tag registry.example.com/custom/rhpam-kieserver-rhel8:7.12.0

7. 要将自定义镜像推送到 registry 中，请输入以下命令：

   podman push registry_address/image_name:7.12.0 docker://registry_address/image_name:7.12.0

   例如：

   podman push registry.example.com/custom/rhpam-kieserver-rhel8:7.12.0 docker://registry.example.com/custom/rhpam-kieserver-rhel8:7.12.0

流程

1. 从 GitHub 存储库 下载路由器扩展示例源。
2. 根据需要修改路由器扩展的示例源。现有代码根据容器的版本实施简单的路由。

3. 使用 Maven 构建源代码：

   mvn clean package

   构建过程生成以下 JAR 文件： target/router-ext-0.0.1-SNAPSHOT.jar

4. 创建用于创建自定义镜像的工作目录，将生成的 JAR 文件复制到目录中，然后更改到该目录，例如：

   mkdir /tmp/smartrouter
   cp target/router-ext-0.0.1-SNAPSHOT.jar /tmp/smartrouter
   cd /tmp/smartrouter

5. 使用 podman login 命令向 registry.redhat.io registry 进行身份验证。有关向 registry 进行身份验证的说明，请参阅 Red Hat Container Registry 身份验证。

6. 要下载支持的智能路由器基础镜像，请输入以下命令：

   podman pull registry.redhat.io/rhpam-7/rhpam-smartrouter-rhel8:7.12.0

7. 从官方智能路由器镜像中提取 openshift-launch.sh 文件：

   podman run --rm registry.redhat.io/rhpam-7/rhpam-smartrouter-rhel8:7.12.0 \
      cat /opt/rhpam-smartrouter/openshift-launch.sh > openshift-launch.sh

8. 编辑 openshift-launch.sh 文件。在文件的最后一行中，找到类似如下的 exec 指令：

   exec ${JAVA_HOME}/bin/java ${SHOW_JVM_SETTINGS} ${JAVA_OPTS} ${JAVA_OPTS_APPEND} ${JAVA_PROXY_OPTIONS} "${D_ARR[@]}" -jar /opt/${JBOSS_PRODUCT}/${KIE_ROUTER_DISTRIBUTION_JAR}

   将指令改为以下文本：

   exec ${JAVA_HOME}/bin/java ${SHOW_JVM_SETTINGS} "${D_ARR[@]}" \
       -cp /opt/${JBOSS_PRODUCT}/router-ext-0.0.1-SNAPSHOT.jar:/opt/${JBOSS_PRODUCT}/${KIE_ROUTER_DISTRIBUTION_JAR} \
       org.kie.server.router.KieServerRouter

   此更改会将扩展 JAR 文件添加到 Java 类路径。

9. 创建一个 Dockerfile 文件，该文件基于基础镜像定义自定义镜像。以下示例显示了 Dockerfile 文件的内容：

   FROM registry.redhat.io/rhpam-7/rhpam-smartrouter-rhel8:7.12.0
   RUN rm -rfv /opt/rhpam-smartrouter/openshift-launch.sh
   COPY openshift-launch.sh  /opt/rhpam-smartrouter/openshift-launch.sh
   COPY router-ext-0.0.1-SNAPSHOT.jar /opt/rhpam-smartrouter/router-ext-0.0.1-SNAPSHOT.jar
   
   USER root
   RUN chown jboss. /opt/rhpam-smartrouter/router-ext-0.0.1-SNAPSHOT.jar /opt/rhpam-smartrouter/openshift-launch.sh
   RUN chmod +x /opt/rhpam-smartrouter/openshift-launch.sh
   USER 185

   此文件包括以下操作：

   • 添加 JAR 文件和新的 openshift-launch.sh 文件
   • 将当前用户更改为 root
   • 为 openshift-launch.sh 文件设置所需的权限
   • 恢复到 USER 185，即红帽 JBoss EAP 用户
10. 使用 oc 命令登录到您的 Red Hat OpenShift Container Platform 集群。
11. 使用 podman login 命令登录到 Red Hat OpenShift Container Platform 集群 registry。

12. 使用 Dockerfile 构建自定义镜像。为 Red Hat OpenShift Container Platform 集群 registry 和项目命名空间标记镜像。对镜像使用自定义名称，以及与基础镜像版本相同的版本标签。要构建镜像，请输入以下命令：

    podman build . --tag registry-route/project-name_/image-name:7.12.0

    例如：

    podman build . --tag route-openshift-image-registry.openshift.example.com/rhpam-project/rhpam-smartrouter-rhel8-custom:7.12.0

13. 构建完成后，运行镜像并验证自定义是否成功。使用以下命令：

    podman run registry-route/project-name/image-name:7.12.0

    例如：

    podman run route-openshift-image-registry.openshift.example.com/rhpam-project/rhpam-smartrouter-rhel8-custom:7.12.0

    确保输出提到自定义服务，如下例所示：

    INFO: Using 'LatestVersionContainerResolver' container resolver and restriction policy 'ByPassUserNotAllowedRestrictionPolicy'

14. 将自定义镜像推送到 registry 中：

    podman push registry-route/project-name/image-name:7.12.0

    例如：

    podman push route-openshift-image-registry.openshift.example.com/rhpam-project/rhpam-smartrouter-rhel8-custom:7.12.0

流程

1. 从红帽客户门户网站的 Software Downloads 页面下载 rhpam-7.12.0-openshift-templates.zip 产品提供的可交付文件。
2. 提取所需的模板文件。

3. 使用以下方法之一开始部署模板：

   • 要使用 OpenShift Web UI，在 OpenShift 应用程序控制台中选择 Add to Project → Import YAML / JSON，然后选择或粘贴 < template-file-name>.yaml 文件。在 Add Template 窗口中 ，确保选择了模板 并单击 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 对来设置所需的参数。

流程

1. 设置以下参数：

   • 凭证 secret (CREDENTIALS_SECRET)：包含管理用户凭证的 secret 名称，如 第 7.5 节 “为管理用户创建 secret” 中创建。
   • Business Central Server Keystore Secret Name (BUSINESS_CENTRAL_HTTPS_SECRET): Business Central 的机密名称，如 第 7.3 节 “为 Business Central 创建 secret” 中创建。
   • KIE Server Keystore Secret Name (KIE_SERVER_HTTPS_SECRET)：KIE 服务器的 secret 名称，如 第 7.2 节 “为 KIE 服务器创建 secret” 中创建的。
   • Business Central Server 证书名称 (BUSINESS_CENTRAL_HTTPS_NAME)：您在 第 7.3 节 “为 Business Central 创建 secret” 中创建的密钥存储中的证书名称。
   • Business Central Server Keystore Password (BUSINESS_CENTRAL_HTTPS_PASSWORD)：您在 第 7.3 节 “为 Business Central 创建 secret” 中创建的密钥存储的密码。
   • KIE 服务器证书名称 (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 服务器的默认 URL。OpenShift 使用应用程序名称来创建单独的一组部署配置、服务、路由、标签和工件。
   • ImageStream Namespace (IMAGE_STREAM_NAMESPACE)：镜像流可用的命名空间。如果 OpenShift 环境中已存在镜像流（请参阅 第 7.1 节 “确保镜像流和镜像 registry 的可用性”），则命名空间为 openshift。如果您已安装镜像流文件，则命名空间是 OpenShift 项目的名称。

流程

1. 设置以下参数：

   • RH-SSO URL (SSO_URL): RH-SSO 的 URL。
   • RH-SSO Realm 名称 (SSO_REALM)：红帽流程自动化管理器的 RH-SSO 域。
   • RH-SSO 禁用 SSL 证书验证 (SSO_DISABLE_SSL_CERTIFICATE_VALIDATION):如果您的 RH-SSO 安装不使用有效的 HTTPS 证书，则设置为 true。

2. 完成以下流程之一：

   1. 如果您在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端，请在模板中设置以下参数：

      • Business Central RH-SSO 客户端名称 (BUSINESS_CENTRAL_SSO_CLIENT): Business Central 的 RH-SSO 客户端名称。
      • Business Central RH-SSO Client Secret (BUSINESS_CENTRAL_SSO_SECRET)：在 RH-SSO 中为 Business Central 设定的机密字符串。
      • KIE Server RH-SSO Client name (KIE_SERVER_SSO_CLIENT): KIE Server 的 RH-SSO 客户端名称。
      • KIE Server RH-SSO Client Secret (KIE_SERVER_SSO_SECRET): KIE Server 客户端的 RH-SSO 中设置的机密字符串。

   2. 要在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端，请在模板中设置以下参数：

      • Business Central RH-SSO 客户端名称 (BUSINESS_CENTRAL_SSO_CLIENT)：要在 RH-SSO 中为 Business Central 创建的客户端名称。
      • Business Central RH-SSO Client Secret (BUSINESS_CENTRAL_SSO_SECRET)：在 RH-SSO 中为 Business Central 设置的机密字符串。
      • KIE Server RH-SSO 客户端名称 (KIE_SERVER_SSO_CLIENT)：要在 KIE 服务器的 RH-SSO 中创建的客户端名称。
      • KIE Server RH-SSO Client Secret (KIE_SERVER_SSO_SECRET): KIE Server 客户端的 RH-SSO 中设置的机密字符串。
      • RH-SSO Realm Admin Username (SSO_USERNAME)和 RH-SSO Realm Admin Password (SSO_PASSWORD)：红帽流程自动化管理器的 RH-SSO 域的用户名和密码。您必须提供此用户名和密码来创建所需的客户端。

流程

1. 设置模板的 AUTH_LDAP* 参数。这些参数使用红帽 JBoss EAP 的 Elytron 子系统配置 LDAP 身份验证。有关在 LDAP 中使用 Red Hat JBoss EAP 的 Elytron 子系统的更多信息，请参阅使用 基于 LDAP 的身份存储配置身份验证。

   注意

   如果要启用 LDAP 故障转移，您可以在 AUTH_LDAP_URL 参数中放置设置或更多 LDAP 服务器地址，用空格分隔。

   如果 LDAP 服务器没有定义部署所需的所有角色，您可以将 LDAP 组映射到 Red Hat Process Automation Manager 角色。要启用 LDAP 角色映射，请设置以下参数：

   • RoleMapping rolesProperties 文件路径或一行角色 (AUTH_ROLE_MAPPER_ROLES_PROPERTIES)：定义角色映射的文件的完全限定路径名称，如 /opt/eap/standalone/configuration/rolemapping.properties。您必须提供此文件，并在所有适用的部署配置中的这个路径中挂载该文件 ; 有关说明，请参阅 第 13.3 节 “（可选）提供 LDAP 角色映射文件”。

     或者，您可以使用 role=role1,role2;another-role=role2 pattern （如 admins=kie-server,rest-all,admin;developers=kie-server,rest-all,admin;developers=kie-server,rest-all ）在此属性中输入角色映射设置。

   • 角色映射程序 Keep Mapped (AUTH_LDAP_MAPPER_KEEP_MAPPED)：如果设为 true，则 LDAP 服务器上定义的映射角色和角色都设置为 用户应用角色；如果设为 false，则映射的角色将替换 LDAP 服务器上定义的角色。默认设置为 false。
   • 角色映射程序 Keep Non-mapped (AUTH_LDAP_MAPPER_KEEP_NON_MAPPED)：如果设为 true，则 LDAP 服务器上定义的角色不是用户应用角色；如果设为 false，则没有映射的角色会被删除。默认设置为 false。

流程

1. 设置以下参数：

   • KIE 服务器外部数据库 驱动程序(KIE_SERVER_EXTERNALDB_DRIVER)：服务器的驱动程序，具体取决于服务器类型：

     • mysql
     • postgresql
     • mariadb
     • mssql
     • db2
     • oracle
     • sisu
   • KIE Server External Database User (KIE_SERVER_EXTERNALDB_USER)和 KIE Server External Database Password (KIE_SERVER_EXTERNALDB_PWD)：外部数据库服务器的用户名和密码

   • KIE Server External Database URL (KIE_SERVER_EXTERNALDB_URL)：外部数据库服务器的 JDBC URL

     注意

     如果您使用 EntrepriseDB Postgres 数据库服务器，请使用以 jdbc:postgresql:// 开头的 URL，而不使用 jdbc:edb://。或者，不要设置 URL，而是设置主机和端口参数。

   • KIE Server External Database Host (KIE_SERVER_EXTERNALDB_SERVICE_HOST)和 KIE Server External Database Port (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 （用于 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 连接检查器类 (KIE_SERVER_EXTERNALDB_CONNECTION_CHECKER): 数据库服务器的 JDBC 连接检查程序类的名称。如果没有此信息，则数据库服务器连接在丢失后无法恢复，例如，如果数据库服务器被重启。
   • JDBC Exception Sorter 类 (KIE_SERVER_EXTERNALDB_EXCEPTION_SORTER)：数据库服务器的 JDBC 异常分类器类的名称。如果没有此信息，则数据库服务器连接在丢失后无法恢复，例如，如果数据库服务器被重启。

2. 如果您为使用外部数据库服务器创建了自定义镜像，如 第 7.10 节 “为外部数据库构建自定义 KIE 服务器扩展镜像” 所述，请设置以下参数：

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

3. 如果您使用 MySQL 版本 8 外部数据库服务器，请启用 mysql_native_password 插件并使用它来进行身份验证。有关此插件的说明，请参阅 MySQL 8.0 Reference Manual 中的 原生可插拔身份验证。

   如果您在 Red Hat OpenShift Container Platform 上使用红帽提供的 MySQL 版本 8 镜像来启用该插件，请将 MYSQL_DEFAULT_AUTHENTICATION_PLUGIN 环境变量设置为 mysql_native_password。

   如果您在启用 mysql_native_password 插件前在 MySQL 版本 8 服务器上创建了用户，则必须在启用插件后更新 mysql-user 表。

流程

1. 通过设置以下环境变量来禁用自动 EJB 计时器配置：

   • AUTO_CONFIGURE_ejb_TIMER 设置为 false。
   • EJB_TIMER 数据源前缀放在 DATASOURCES 环境变量上的 RHPAM 数据库之前，例如：DATASOURCE S="EJB_TIMER,RHPAM"。

   • 以下 XA 变量：

     EJB_TIMER_XA_CONNECTION_PROPERTY_URL=<url>

     EJB_TIMER_NONXA="false"

   • 使用 JAVA_OPTS_APPEND 的以下系统属性：

     -Dorg.jbpm.ejb.timer.tx=true

     -Dorg.jbpm.ejb.timer.local.cache=false

流程

1. 从红帽客户门户网站的 Software Downloads 页面下载 rhpam-7.12.0-openshift-templates.zip 产品提供的可交付文件。
2. 提取 rhpam712-immutable-monitor.yaml 模板文件。

3. 使用以下方法之一开始部署模板：

   • 要使用 OpenShift Web UI，在 OpenShift 应用程序控制台中选择 Add to Project → Import YAML / JSON，然后选择或粘贴 rhpam712-immutable-monitor.yaml 文件。在 Add Template 窗口中 ，确保选择了模板 并单击 Continue。

   • 要使用 OpenShift 命令行控制台，请准备以下命令行：

     oc new-app -f <template-path>/rhpam712-immutable-monitor.yaml -p BUSINESS_CENTRAL_HTTPS_SECRET=businesscentral-app-secret -p PARAMETER=value

     在这个命令行中，进行以下更改：

     • 将 <template-path > 替换为下载的模板文件的路径。
     • 根据需要，使用多个 -p PARAMETER=value 对来设置所需的参数。

流程

1. 设置以下参数：

   • 凭证 secret (CREDENTIALS_SECRET)：包含管理用户凭证的 secret 名称，如 第 7.5 节 “为管理用户创建 secret” 中创建。
   • Business Central Monitoring Server Keystore Secret Name (BUSINESS_CENTRAL_HTTPS_SECRET): Business Central 的机密名称，如 第 7.3 节 “为 Business Central 创建 secret” 中创建。
   • Smart Router Keystore Secret Name (KIE_SERVER_ROUTER_HTTPS_SECRET): 智能路由器 secret 的名称，如 第 7.4 节 “为智能路由器创建 secret” 中创建。
   • Business Central 监控服务器证书名称 (BUSINESS_CENTRAL_HTTPS_NAME)：您在 第 7.3 节 “为 Business Central 创建 secret” 中创建的密钥存储中的证书名称。
   • Business Central Monitoring Server Keystore Password (BUSINESS_CENTRAL_HTTPS_PASSWORD)：您在 第 7.3 节 “为 Business Central 创建 secret” 中创建的密钥存储的密码。
   • 智能路由器证书名称 (KIE_SERVER_ROUTER_HTTPS_NAME)：您在 第 7.4 节 “为智能路由器创建 secret” 中创建的密钥存储中的证书名称。
   • Smart Router Keystore Password (KIE_SERVER_ROUTER_HTTPS_PASSWORD)：您在 第 7.4 节 “为智能路由器创建 secret” 中创建的密钥存储的密码。
   • 应用名称 (APPLICATION_NAME)：OpenShift 应用的名称。它用于 Business Central Monitoring 和 KIE 服务器的默认 URL。OpenShift 使用应用程序名称来创建单独的一组部署配置、服务、路由、标签和工件。
   • 启用 KIE 服务器全局发现 (KIE_SERVER_CONTROLLER_OPENSHIFT_GLOBAL_DISCOVERY_ENABLED)：如果您希望 Business Central Monitoring 使用同一命名空间中的 OpenShiftStartupStrategy 发现所有 KIE 服务器，请将此参数设置为 true。默认情况下，Business Central Monitoring 仅会发现使用与 Business Central Monitoring 本身相同的 APPLICATION_NAME 参数的值部署的 KIE 服务器。
   • Maven 存储库 URL (MAVEN_REPO_URL): Maven 存储库的 URL。您必须将要在环境中任何 KIE 服务器实例上部署的所有进程(KJAR 文件)上传到此存储库中。
   • Maven 存储库 ID (MAVEN_REPO_ID)：Maven 存储库的标识符。默认值为 repo-custom。
   • Maven 存储库用户名 (MAVEN_REPO_USERNAME): Maven 存储库的用户名。
   • Maven 存储库密码 (MAVEN_REPO_PASSWORD): Maven 存储库的密码。
   • ImageStream Namespace (IMAGE_STREAM_NAMESPACE)：镜像流可用的命名空间。如果 OpenShift 环境中已存在镜像流（请参阅 第 7.1 节 “确保镜像流和镜像 registry 的可用性”），则命名空间为 openshift。如果您已安装镜像流文件，则命名空间是 OpenShift 项目的名称。

流程

1. 设置以下参数：

   • RH-SSO URL (SSO_URL): RH-SSO 的 URL。
   • RH-SSO Realm 名称 (SSO_REALM)：红帽流程自动化管理器的 RH-SSO 域。
   • RH-SSO 禁用 SSL 证书验证 (SSO_DISABLE_SSL_CERTIFICATE_VALIDATION):如果您的 RH-SSO 安装不使用有效的 HTTPS 证书，则设置为 true。

2. 完成以下流程之一：

   1. 如果您在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端，请在模板中设置以下参数：

      • Business Central Monitoring RH-SSO Client name (BUSINESS_CENTRAL_SSO_CLIENT): Business Central Monitoring 的 RH-SSO 客户端名称。
      • Business Central Monitoring RH-SSO Client Secret (BUSINESS_CENTRAL_SSO_SECRET)：用于 Business Central Monitoring 客户端的 RH-SSO 中设置的机密字符串。

   2. 要在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端，请在模板中设置以下参数：

      • Business Central Monitoring RH-SSO Client name (BUSINESS_CENTRAL_SSO_CLIENT)：要在 RH-SSO 中为 Business Central Monitoring 创建的客户端名称。
      • Business Central Monitoring RH-SSO Client Secret (BUSINESS_CENTRAL_SSO_SECRET)：用于 Business Central Monitoring 客户端的 RH-SSO 中设置的机密字符串。
      • RH-SSO Realm Admin Username (SSO_USERNAME)和 RH-SSO Realm Admin Password (SSO_PASSWORD)：红帽流程自动化管理器的 RH-SSO 域的用户名和密码。您必须提供此用户名和密码来创建所需的客户端。

流程

1. 设置模板的 AUTH_LDAP* 参数。这些参数使用红帽 JBoss EAP 的 Elytron 子系统配置 LDAP 身份验证。有关在 LDAP 中使用 Red Hat JBoss EAP 的 Elytron 子系统的更多信息，请参阅使用 基于 LDAP 的身份存储配置身份验证。

   注意

   如果要启用 LDAP 故障转移，您可以在 AUTH_LDAP_URL 参数中放置设置或更多 LDAP 服务器地址，用空格分隔。

   如果 LDAP 服务器没有定义部署所需的所有角色，您可以将 LDAP 组映射到 Red Hat Process Automation Manager 角色。要启用 LDAP 角色映射，请设置以下参数：

   • RoleMapping rolesProperties 文件路径或一行角色 (AUTH_ROLE_MAPPER_ROLES_PROPERTIES)：定义角色映射的文件的完全限定路径名称，如 /opt/eap/standalone/configuration/rolemapping.properties。您必须提供此文件，并在所有适用的部署配置中的这个路径中挂载该文件 ; 有关说明，请参阅 第 13.3 节 “（可选）提供 LDAP 角色映射文件”。

     或者，您可以使用 role=role1,role2;another-role=role2 pattern （如 admins=kie-server,rest-all,admin;developers=kie-server,rest-all,admin;developers=kie-server,rest-all ）在此属性中输入角色映射设置。

   • 角色映射程序 Keep Mapped (AUTH_LDAP_MAPPER_KEEP_MAPPED)：如果设为 true，则 LDAP 服务器上定义的映射角色和角色都设置为 用户应用角色；如果设为 false，则映射的角色将替换 LDAP 服务器上定义的角色。默认设置为 false。
   • 角色映射程序 Keep Non-mapped (AUTH_LDAP_MAPPER_KEEP_NON_MAPPED)：如果设为 true，则 LDAP 服务器上定义的角色不是用户应用角色；如果设为 false，则没有映射的角色会被删除。默认设置为 false。

流程

1. 从红帽客户门户网站的 Software Downloads 页面下载 rhpam-7.12.0-openshift-templates.zip 产品提供的可交付文件。
2. 提取所需的模板文件。
3. 默认情况下，模板包含两个 KIE 服务器。每个服务都使用 pod 中的 PostgreSQL 数据库服务器。要更改 KIE Servers 的数量或使用 pod 或外部数据库服务器中的 MySQL 数据库服务器，请修改模板，如 第 10.3 节 “修改模板以使用 S2I 部署不可变 KIE 服务器” 所述。

4. 使用以下方法之一开始部署模板：

   • 要使用 OpenShift Web UI，在 OpenShift 应用程序控制台中选择 Add to Project → Import YAML / JSON，然后选择或粘贴 < template-file-name>.yaml 文件。在 Add Template 窗口中 ，确保选择了模板 并单击 Continue。

   • 要使用 OpenShift 命令行控制台，请准备以下命令行：

     oc new-app -f <template-path>/<template-file-name>.yaml -p KIE_SERVER_HTTPS_SECRET=kieserver-app-secret -p PARAMETER=value

     在这个命令行中，进行以下更改：

     • 将 <template-path > 替换为下载的模板文件的路径。
     • 将 <template-file-name > 替换为模板文件的名称。
     • 根据需要，使用多个 -p PARAMETER=value 对来设置所需的参数。

流程

1. 设置以下参数：

   • 凭证 secret (CREDENTIALS_SECRET)：包含管理用户凭证的 secret 名称，如 第 7.5 节 “为管理用户创建 secret” 中创建。
   • KIE Server Keystore Secret Name (KIE_SERVER_HTTPS_SECRET)：KIE 服务器的 secret 名称，如 第 7.2 节 “为 KIE 服务器创建 secret” 中创建的。
   • KIE 服务器证书名称 (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 服务器的默认 URL。OpenShift 使用应用程序名称来创建单独的一组部署配置、服务、路由、标签和工件。只要使用不同的应用名称，就可以使用同一模板将多个应用部署到同一项目中。另外，应用程序名称决定了此 KIE Server 实例在 Business Central 或 Business Central Monitoring 上加入的服务器配置（服务器模板）的名称。如果要部署多个 KIE 服务器实例，您必须确保每个服务器都有不同的应用程序名称。

   • KIE Server Container Deployment (KIE_SERVER_CONTAINER_DEPLOYMENT)：在构建源后，部署必须从本地或外部存储库拉取的信息。格式为 <containerId>=<groupId>:<artifactId>:<version>，或如果您要为容器设置一个别名，则为<containerId>(<aliasId>)=<groupId>:<artifactId>:<version>。您可以使用 | 分隔符提供两个或多个 KJAR 文件，如下例所示：

     containerId=groupId:artifactId:version|c2(alias2)=g2:a2:v2

     为避免重复的容器 ID，工件 ID 必须与项目中构建或所使用的每个工件都是唯一的。

   • Git Repository URL (SOURCE_REPOSITORY_URL)：包含服务源的 Git 存储库的 URL。
   • Git Reference (SOURCE_REPOSITORY_REF): Git 存储库中的分支。
   • 上下文目录 (CONTEXT_DIR)：从 Git 存储库下载的项目中源的路径。
   • 工件 目录(ARTIFACT_DIR)：项目内的路径，其中包含成功 Maven 构建后所需的二进制文件(KJAR 文件和任何其他必要的文件)。通常，此目录是构建的目标目录。但是，您可以在 Git 存储库中的这个目录中提供预构建二进制文件。
   • ImageStream Namespace (IMAGE_STREAM_NAMESPACE)：镜像流可用的命名空间。如果 OpenShift 环境中已存在镜像流（请参阅 第 7.1 节 “确保镜像流和镜像 registry 的可用性”），则命名空间为 openshift。如果您已安装镜像流文件，则命名空间是 OpenShift 项目的名称。

流程

1. 设置以下参数：

   • Name of the Business Central service (BUSINESS_CENTRAL_SERVICE): Business Central 或 Business Central Monitoring 的 OpenShift 服务名称。

流程

1. 设置以下参数：

   • RH-SSO URL (SSO_URL): RH-SSO 的 URL。
   • RH-SSO Realm 名称 (SSO_REALM)：红帽流程自动化管理器的 RH-SSO 域。
   • RH-SSO 禁用 SSL 证书验证 (SSO_DISABLE_SSL_CERTIFICATE_VALIDATION):如果您的 RH-SSO 安装不使用有效的 HTTPS 证书，则设置为 true。

2. 完成以下流程之一：

   1. 如果您在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端，请在模板中设置以下参数：

      • Business Central 或 Business Central Monitoring RH-SSO Client name (BUSINESS_CENTRAL_SSO_CLIENT): Business Central 或 Business Central Monitoring 的 RH-SSO 客户端名称。
      • KIE Server RH-SSO Client name (KIE_SERVER_SSO_CLIENT): KIE Server 的 RH-SSO 客户端名称。
      • KIE Server RH-SSO Client Secret (KIE_SERVER_SSO_SECRET): KIE Server 客户端的 RH-SSO 中设置的机密字符串。

   2. 要在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端，请在模板中设置以下参数：

      • KIE Server RH-SSO 客户端名称 (KIE_SERVER_SSO_CLIENT)：要在 KIE 服务器的 RH-SSO 中创建的客户端名称。
      • KIE Server RH-SSO Client Secret (KIE_SERVER_SSO_SECRET): KIE Server 客户端的 RH-SSO 中设置的机密字符串。
      • RH-SSO Realm Admin Username (SSO_USERNAME)和 RH-SSO Realm Admin Password (SSO_PASSWORD)：红帽流程自动化管理器的 RH-SSO 域的用户名和密码。您必须提供此用户名和密码来创建所需的客户端。

流程

1. 设置模板的 AUTH_LDAP* 参数。这些参数使用红帽 JBoss EAP 的 Elytron 子系统配置 LDAP 身份验证。有关在 LDAP 中使用 Red Hat JBoss EAP 的 Elytron 子系统的更多信息，请参阅使用 基于 LDAP 的身份存储配置身份验证。

   注意

   如果要启用 LDAP 故障转移，您可以在 AUTH_LDAP_URL 参数中放置设置或更多 LDAP 服务器地址，用空格分隔。

   如果 LDAP 服务器没有定义部署所需的所有角色，您可以将 LDAP 组映射到 Red Hat Process Automation Manager 角色。要启用 LDAP 角色映射，请设置以下参数：

   • RoleMapping rolesProperties 文件路径或一行角色 (AUTH_ROLE_MAPPER_ROLES_PROPERTIES)：定义角色映射的文件的完全限定路径名称，如 /opt/eap/standalone/configuration/rolemapping.properties。您必须提供此文件，并在所有适用的部署配置中的这个路径中挂载该文件 ; 有关说明，请参阅 第 13.3 节 “（可选）提供 LDAP 角色映射文件”。

     或者，您可以使用 role=role1,role2;another-role=role2 pattern （如 admins=kie-server,rest-all,admin;developers=kie-server,rest-all,admin;developers=kie-server,rest-all ）在此属性中输入角色映射设置。

   • 角色映射程序 Keep Mapped (AUTH_LDAP_MAPPER_KEEP_MAPPED)：如果设为 true，则 LDAP 服务器上定义的映射角色和角色都设置为 用户应用角色；如果设为 false，则映射的角色将替换 LDAP 服务器上定义的角色。默认设置为 false。
   • 角色映射程序 Keep Non-mapped (AUTH_LDAP_MAPPER_KEEP_NON_MAPPED)：如果设为 true，则 LDAP 服务器上定义的角色不是用户应用角色；如果设为 false，则没有映射的角色会被删除。默认设置为 false。

流程

1. 设置以下参数：

   • KIE 服务器外部数据库 驱动程序(KIE_SERVER_EXTERNALDB_DRIVER)：服务器的驱动程序，具体取决于服务器类型：

     • mysql
     • postgresql
     • mariadb
     • mssql
     • db2
     • oracle
     • sisu
   • KIE Server External Database User (KIE_SERVER_EXTERNALDB_USER)和 KIE Server External Database Password (KIE_SERVER_EXTERNALDB_PWD)：外部数据库服务器的用户名和密码

   • KIE Server External Database URL (KIE_SERVER_EXTERNALDB_URL)：外部数据库服务器的 JDBC URL

     注意

     如果您使用 EntrepriseDB Postgres 数据库服务器，请使用以 jdbc:postgresql:// 开头的 URL，而不使用 jdbc:edb://。或者，不要设置 URL，而是设置主机和端口参数。

   • KIE Server External Database Host (KIE_SERVER_EXTERNALDB_SERVICE_HOST)和 KIE Server External Database Port (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 （用于 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 连接检查器类 (KIE_SERVER_EXTERNALDB_CONNECTION_CHECKER): 数据库服务器的 JDBC 连接检查程序类的名称。如果没有此信息，则数据库服务器连接在丢失后无法恢复，例如，如果数据库服务器被重启。
   • JDBC Exception Sorter 类 (KIE_SERVER_EXTERNALDB_EXCEPTION_SORTER)：数据库服务器的 JDBC 异常分类器类的名称。如果没有此信息，则数据库服务器连接在丢失后无法恢复，例如，如果数据库服务器被重启。

2. 如果您为使用外部数据库服务器创建了自定义镜像，如 第 7.10 节 “为外部数据库构建自定义 KIE 服务器扩展镜像” 所述，请设置以下参数：

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

3. 如果您使用 MySQL 版本 8 外部数据库服务器，请启用 mysql_native_password 插件并使用它来进行身份验证。有关此插件的说明，请参阅 MySQL 8.0 Reference Manual 中的 原生可插拔身份验证。

   如果您在 Red Hat OpenShift Container Platform 上使用红帽提供的 MySQL 版本 8 镜像来启用该插件，请将 MYSQL_DEFAULT_AUTHENTICATION_PLUGIN 环境变量设置为 mysql_native_password。

   如果您在启用 mysql_native_password 插件前在 MySQL 版本 8 服务器上创建了用户，则必须在启用插件后更新 mysql-user 表。

流程

1. 从红帽客户门户网站的 Software Downloads 页面下载 rhpam-7.12.0-openshift-templates.zip 产品提供的可交付文件。
2. 提取所需的模板文件。

3. 使用以下方法之一开始部署模板：

   • 要使用 OpenShift Web UI，在 OpenShift 应用程序控制台中选择 Add to Project → Import YAML / JSON，然后选择或粘贴 < template-file-name>.yaml 文件。在 Add Template 窗口中 ，确保选择了模板 并单击 Continue。

   • 要使用 OpenShift 命令行控制台，请准备以下命令行：

     oc new-app -f <template-path>/<template-file-name>.yaml -p KIE_SERVER_HTTPS_SECRET=kieserver-app-secret -p PARAMETER=value

     在这个命令行中，进行以下更改：

     • 将 <template-path > 替换为下载的模板文件的路径。
     • 将 <template-file-name > 替换为模板文件的名称。
     • 根据需要，使用多个 -p PARAMETER=value 对来设置所需的参数。

流程

1. 设置以下参数：

   • 凭证 secret (CREDENTIALS_SECRET)：包含管理用户凭证的 secret 名称，如 第 7.5 节 “为管理用户创建 secret” 中创建。
   • KIE Server Keystore Secret Name (KIE_SERVER_HTTPS_SECRET)：KIE 服务器的 secret 名称，如 第 7.2 节 “为 KIE 服务器创建 secret” 中创建的。
   • KIE 服务器证书名称 (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 服务器的默认 URL。OpenShift 使用应用程序名称来创建单独的一组部署配置、服务、路由、标签和工件。只要使用不同的应用名称，就可以使用同一模板将多个应用部署到同一项目中。另外，应用程序名称决定了此 KIE Server 实例在 Business Central 或 Business Central Monitoring 上加入的服务器配置（服务器模板）的名称。如果要部署多个 KIE 服务器实例，您必须确保每个服务器都有不同的应用程序名称。
   • Maven 存储库 URL (MAVEN_REPO_URL): Maven 存储库的 URL。您必须将要在 KIE 服务器上部署的所有进程(KJAR 文件)上传到此存储库。
   • Maven 存储库 ID (MAVEN_REPO_ID)：Maven 存储库的标识符。默认值为 repo-custom。
   • Maven 存储库用户名 (MAVEN_REPO_USERNAME): Maven 存储库的用户名。
   • Maven 存储库密码 (MAVEN_REPO_PASSWORD): Maven 存储库的密码。

   • KIE Server Container Deployment (KIE_SERVER_CONTAINER_DEPLOYMENT)：部署必须从 Maven 存储库拉取的决策服务(KJAR 文件)的识别信息。格式为 <containerId>=<groupId>:<artifactId>:<version>，或如果您要为容器设置一个别名，则为<containerId>(<aliasId>)=<groupId>:<artifactId>:<version>。您可以使用 | 分隔符提供两个或多个 KJAR 文件，如下例所示：

     containerId=groupId:artifactId:version|c2(alias2)=g2:a2:v2

   • KIE Server Mode (KIE_SERVER_MODE): 在 rhpam712-kieserver-*.yaml 模板中，默认值为 PRODUCTION。在 PRODUCTION 模式中，您无法在此 KIE Server 实例上部署 SNAPSHOT 版本 KJAR 工件，且无法更改现有容器中的工件版本。要使用 PRODUCTION 模式 部署新版本，请在同一 KIE 服务器上创建一个新容器。要部署 SNAPSHOT 版本或更改现有容器中的工件版本，请将此参数设置为 DEVELOPMENT。
   • ImageStream Namespace (IMAGE_STREAM_NAMESPACE)：镜像流可用的命名空间。如果 OpenShift 环境中已存在镜像流（请参阅 第 7.1 节 “确保镜像流和镜像 registry 的可用性”），则命名空间为 openshift。如果您已安装镜像流文件，则命名空间是 OpenShift 项目的名称。

流程

1. 设置以下参数：

   • Name of the Business Central service (BUSINESS_CENTRAL_SERVICE): Business Central 或 Business Central Monitoring 的 OpenShift 服务名称。

2. 确保将以下设置的值与 Business Central 或 Business Central Monitoring 设置相同：

   • Maven 存储库 URL (MAVEN_REPO_URL)：必须从中部署服务的外部 Maven 存储库的 URL。
   • Maven 存储库用户名 (MAVEN_REPO_USERNAME): Maven 存储库的用户名。
   • Maven 存储库密码 (MAVEN_REPO_PASSWORD): Maven 存储库的密码。

流程

1. 设置以下参数：

   • RH-SSO URL (SSO_URL): RH-SSO 的 URL。
   • RH-SSO Realm 名称 (SSO_REALM)：红帽流程自动化管理器的 RH-SSO 域。
   • RH-SSO 禁用 SSL 证书验证 (SSO_DISABLE_SSL_CERTIFICATE_VALIDATION):如果您的 RH-SSO 安装不使用有效的 HTTPS 证书，则设置为 true。

2. 完成以下流程之一：

   1. 如果您在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端，请在模板中设置以下参数：

      • Business Central 或 Business Central Monitoring RH-SSO Client name (BUSINESS_CENTRAL_SSO_CLIENT): Business Central 或 Business Central Monitoring 的 RH-SSO 客户端名称。
      • KIE Server RH-SSO Client name (KIE_SERVER_SSO_CLIENT): KIE Server 的 RH-SSO 客户端名称。
      • KIE Server RH-SSO Client Secret (KIE_SERVER_SSO_SECRET): KIE Server 客户端的 RH-SSO 中设置的机密字符串。

   2. 要在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端，请在模板中设置以下参数：

      • KIE Server RH-SSO 客户端名称 (KIE_SERVER_SSO_CLIENT)：要在 KIE 服务器的 RH-SSO 中创建的客户端名称。
      • KIE Server RH-SSO Client Secret (KIE_SERVER_SSO_SECRET): KIE Server 客户端的 RH-SSO 中设置的机密字符串。
      • RH-SSO Realm Admin Username (SSO_USERNAME)和 RH-SSO Realm Admin Password (SSO_PASSWORD)：红帽流程自动化管理器的 RH-SSO 域的用户名和密码。您必须提供此用户名和密码来创建所需的客户端。

流程

1. 设置模板的 AUTH_LDAP* 参数。这些参数使用红帽 JBoss EAP 的 Elytron 子系统配置 LDAP 身份验证。有关在 LDAP 中使用 Red Hat JBoss EAP 的 Elytron 子系统的更多信息，请参阅使用 基于 LDAP 的身份存储配置身份验证。

   注意

   如果要启用 LDAP 故障转移，您可以在 AUTH_LDAP_URL 参数中放置设置或更多 LDAP 服务器地址，用空格分隔。

   如果 LDAP 服务器没有定义部署所需的所有角色，您可以将 LDAP 组映射到 Red Hat Process Automation Manager 角色。要启用 LDAP 角色映射，请设置以下参数：

   • RoleMapping rolesProperties 文件路径或一行角色 (AUTH_ROLE_MAPPER_ROLES_PROPERTIES)：定义角色映射的文件的完全限定路径名称，如 /opt/eap/standalone/configuration/rolemapping.properties。您必须提供此文件，并在所有适用的部署配置中的这个路径中挂载该文件 ; 有关说明，请参阅 第 13.3 节 “（可选）提供 LDAP 角色映射文件”。

     或者，您可以使用 role=role1,role2;another-role=role2 pattern （如 admins=kie-server,rest-all,admin;developers=kie-server,rest-all,admin;developers=kie-server,rest-all ）在此属性中输入角色映射设置。

   • 角色映射程序 Keep Mapped (AUTH_LDAP_MAPPER_KEEP_MAPPED)：如果设为 true，则 LDAP 服务器上定义的映射角色和角色都设置为 用户应用角色；如果设为 false，则映射的角色将替换 LDAP 服务器上定义的角色。默认设置为 false。
   • 角色映射程序 Keep Non-mapped (AUTH_LDAP_MAPPER_KEEP_NON_MAPPED)：如果设为 true，则 LDAP 服务器上定义的角色不是用户应用角色；如果设为 false，则没有映射的角色会被删除。默认设置为 false。

流程

1. 设置以下参数：

   • KIE 服务器外部数据库 驱动程序(KIE_SERVER_EXTERNALDB_DRIVER)：服务器的驱动程序，具体取决于服务器类型：

     • mysql
     • postgresql
     • mariadb
     • mssql
     • db2
     • oracle
     • sisu
   • KIE Server External Database User (KIE_SERVER_EXTERNALDB_USER)和 KIE Server External Database Password (KIE_SERVER_EXTERNALDB_PWD)：外部数据库服务器的用户名和密码

   • KIE Server External Database URL (KIE_SERVER_EXTERNALDB_URL)：外部数据库服务器的 JDBC URL

     注意

     如果您使用 EntrepriseDB Postgres 数据库服务器，请使用以 jdbc:postgresql:// 开头的 URL，而不使用 jdbc:edb://。或者，不要设置 URL，而是设置主机和端口参数。

   • KIE Server External Database Host (KIE_SERVER_EXTERNALDB_SERVICE_HOST)和 KIE Server External Database Port (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 （用于 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 连接检查器类 (KIE_SERVER_EXTERNALDB_CONNECTION_CHECKER): 数据库服务器的 JDBC 连接检查程序类的名称。如果没有此信息，则数据库服务器连接在丢失后无法恢复，例如，如果数据库服务器被重启。
   • JDBC Exception Sorter 类 (KIE_SERVER_EXTERNALDB_EXCEPTION_SORTER)：数据库服务器的 JDBC 异常分类器类的名称。如果没有此信息，则数据库服务器连接在丢失后无法恢复，例如，如果数据库服务器被重启。

2. 如果您为使用外部数据库服务器创建了自定义镜像，如 第 7.10 节 “为外部数据库构建自定义 KIE 服务器扩展镜像” 所述，请设置以下参数：

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

3. 如果您使用 MySQL 版本 8 外部数据库服务器，请启用 mysql_native_password 插件并使用它来进行身份验证。有关此插件的说明，请参阅 MySQL 8.0 Reference Manual 中的 原生可插拔身份验证。

   如果您在 Red Hat OpenShift Container Platform 上使用红帽提供的 MySQL 版本 8 镜像来启用该插件，请将 MYSQL_DEFAULT_AUTHENTICATION_PLUGIN 环境变量设置为 mysql_native_password。

   如果您在启用 mysql_native_password 插件前在 MySQL 版本 8 服务器上创建了用户，则必须在启用插件后更新 mysql-user 表。

流程

1. 从红帽客户门户网站的 Software Downloads 页面下载 rhpam-7.12.0-openshift-templates.zip 产品提供的可交付文件。
2. 提取 rhpam712-managed.yaml 模板文件。

3. 使用以下方法之一开始部署模板：

   • 要使用 OpenShift Web UI，在 OpenShift 应用程序控制台中选择 Add to Project → Import YAML / JSON，然后选择或粘贴 rhpam712-managed.yaml 文件。在 Add Template 窗口中 ，确保选择了模板 并单击 Continue。

   • 要使用 OpenShift 命令行控制台，请准备以下命令行：

     oc new-app -f <template-path>/rhpam712-managed.yaml -p BUSINESS_CENTRAL_HTTPS_SECRET=businesscentral-app-secret -p KIE_SERVER_HTTPS_SECRET=kieserver-app-secret -p PARAMETER=value

     在这个命令行中，进行以下更改：

     • 将 <template-path > 替换为下载的模板文件的路径。
     • 根据需要，使用多个 -p PARAMETER=value 对来设置所需的参数。

流程

1. 设置以下参数：

   • 凭证 secret (CREDENTIALS_SECRET)：包含管理用户凭证的 secret 名称，如 第 7.5 节 “为管理用户创建 secret” 中创建。
   • Business Central Monitoring Server Keystore Secret Name (BUSINESS_CENTRAL_HTTPS_SECRET): Business Central 的机密名称，如 第 7.3 节 “为 Business Central 创建 secret” 中创建。
   • KIE Server Keystore Secret Name (KIE_SERVER_HTTPS_SECRET)：KIE 服务器的 secret 名称，如 第 7.2 节 “为 KIE 服务器创建 secret” 中创建的。
   • Business Central 监控服务器证书名称 (BUSINESS_CENTRAL_HTTPS_NAME)：您在 第 7.3 节 “为 Business Central 创建 secret” 中创建的密钥存储中的证书名称。
   • Business Central Monitoring Server Keystore Password (BUSINESS_CENTRAL_HTTPS_PASSWORD)：您在 第 7.3 节 “为 Business Central 创建 secret” 中创建的密钥存储的密码。
   • KIE 服务器证书名称 (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 服务器的默认 URL。OpenShift 使用应用程序名称来创建单独的一组部署配置、服务、路由、标签和工件。
   • 启用 KIE 服务器全局发现 (KIE_SERVER_CONTROLLER_OPENSHIFT_GLOBAL_DISCOVERY_ENABLED)：如果您希望 Business Central Monitoring 使用同一命名空间中的 OpenShiftStartupStrategy 发现所有 KIE 服务器，请将此参数设置为 true。默认情况下，Business Central Monitoring 仅会发现使用与 Business Central Monitoring 本身相同的 APPLICATION_NAME 参数的值部署的 KIE 服务器。
   • Maven 存储库 URL (MAVEN_REPO_URL): Maven 存储库的 URL。您必须将要在环境中任何 KIE 服务器实例上部署的所有进程(KJAR 文件)上传到此存储库中。
   • Maven 存储库 ID (MAVEN_REPO_ID)：Maven 存储库的标识符。默认值为 repo-custom。
   • Maven 存储库用户名 (MAVEN_REPO_USERNAME): Maven 存储库的用户名。
   • Maven 存储库密码 (MAVEN_REPO_PASSWORD): Maven 存储库的密码。
   • KIE Server Mode (KIE_SERVER_MODE)：在 rhpam712-managed.yaml 模板中，默认值为 PRODUCTION。在 PRODUCTION 模式中，您无法在此 KIE Server 实例上部署 SNAPSHOT 版本 KJAR 工件，且无法更改现有容器中的工件版本。要使用 PRODUCTION 模式 部署新版本，请在同一 KIE 服务器上创建一个新容器。要部署 SNAPSHOT 版本或更改现有容器中的工件版本，请将此参数设置为 DEVELOPMENT。
   • ImageStream Namespace (IMAGE_STREAM_NAMESPACE)：镜像流可用的命名空间。如果 OpenShift 环境中已存在镜像流（请参阅 第 7.1 节 “确保镜像流和镜像 registry 的可用性”），则命名空间为 openshift。如果您已安装镜像流文件，则命名空间是 OpenShift 项目的名称。

流程

1. 设置以下参数：

   • RH-SSO URL (SSO_URL): RH-SSO 的 URL。
   • RH-SSO Realm 名称 (SSO_REALM)：红帽流程自动化管理器的 RH-SSO 域。
   • RH-SSO 禁用 SSL 证书验证 (SSO_DISABLE_SSL_CERTIFICATE_VALIDATION):如果您的 RH-SSO 安装不使用有效的 HTTPS 证书，则设置为 true。

2. 完成以下流程之一：

   1. 如果您在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端，请在模板中设置以下参数：

      • Business Central Monitoring RH-SSO Client name (BUSINESS_CENTRAL_SSO_CLIENT): Business Central Monitoring 的 RH-SSO 客户端名称。
      • Business Central Monitoring RH-SSO Client Secret (BUSINESS_CENTRAL_SSO_SECRET)：用于 Business Central Monitoring 客户端的 RH-SSO 中设置的机密字符串。
      • KIE Server RH-SSO Client name (KIE_SERVER_SSO_CLIENT): KIE Server 的 RH-SSO 客户端名称。
      • KIE Server RH-SSO Client Secret (KIE_SERVER_SSO_SECRET): KIE Server 客户端的 RH-SSO 中设置的机密字符串。

   2. 要在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端，请在模板中设置以下参数：

      • Business Central Monitoring RH-SSO Client name (BUSINESS_CENTRAL_SSO_CLIENT)：要在 RH-SSO 中为 Business Central Monitoring 创建的客户端名称。
      • Business Central Monitoring RH-SSO Client Secret (BUSINESS_CENTRAL_SSO_SECRET)：用于 Business Central Monitoring 客户端的 RH-SSO 中设置的机密字符串。
      • KIE Server RH-SSO 客户端名称 (KIE_SERVER_SSO_CLIENT)：要在 KIE 服务器的 RH-SSO 中创建的客户端名称。
      • KIE Server RH-SSO Client Secret (KIE_SERVER_SSO_SECRET): KIE Server 客户端的 RH-SSO 中设置的机密字符串。
      • RH-SSO Realm Admin Username (SSO_USERNAME)和 RH-SSO Realm Admin Password (SSO_PASSWORD)：红帽流程自动化管理器的 RH-SSO 域的用户名和密码。您必须提供此用户名和密码来创建所需的客户端。

流程

1. 设置模板的 AUTH_LDAP* 参数。这些参数使用红帽 JBoss EAP 的 Elytron 子系统配置 LDAP 身份验证。有关在 LDAP 中使用 Red Hat JBoss EAP 的 Elytron 子系统的更多信息，请参阅使用 基于 LDAP 的身份存储配置身份验证。

   注意

   如果要启用 LDAP 故障转移，您可以在 AUTH_LDAP_URL 参数中放置设置或更多 LDAP 服务器地址，用空格分隔。

   如果 LDAP 服务器没有定义部署所需的所有角色，您可以将 LDAP 组映射到 Red Hat Process Automation Manager 角色。要启用 LDAP 角色映射，请设置以下参数：

   • RoleMapping rolesProperties 文件路径或一行角色 (AUTH_ROLE_MAPPER_ROLES_PROPERTIES)：定义角色映射的文件的完全限定路径名称，如 /opt/eap/standalone/configuration/rolemapping.properties。您必须提供此文件，并在所有适用的部署配置中的这个路径中挂载该文件 ; 有关说明，请参阅 第 13.3 节 “（可选）提供 LDAP 角色映射文件”。

     或者，您可以使用 role=role1,role2;another-role=role2 pattern （如 admins=kie-server,rest-all,admin;developers=kie-server,rest-all,admin;developers=kie-server,rest-all ）在此属性中输入角色映射设置。

   • 角色映射程序 Keep Mapped (AUTH_LDAP_MAPPER_KEEP_MAPPED)：如果设为 true，则 LDAP 服务器上定义的映射角色和角色都设置为 用户应用角色；如果设为 false，则映射的角色将替换 LDAP 服务器上定义的角色。默认设置为 false。
   • 角色映射程序 Keep Non-mapped (AUTH_LDAP_MAPPER_KEEP_NON_MAPPED)：如果设为 true，则 LDAP 服务器上定义的角色不是用户应用角色；如果设为 false，则没有映射的角色会被删除。默认设置为 false。

流程

1. 从红帽客户门户网站的 Software Downloads 页面下载 rhpam-7.12.0-openshift-templates.zip 产品提供的可交付文件。
2. 提取 {template_name} 模板文件。

3. 使用以下方法之一开始部署模板：

   • 要使用 OpenShift Web UI，在 OpenShift 应用程序控制台中选择 Add to Project → Import YAML / JSON，然后选择或粘贴 {template_name} 文件。在 Add Template 窗口中 ，确保选择了模板 并单击 Continue。

   • 要使用 OpenShift 命令行控制台，请准备以下命令行：

     oc new-app -f <template-path>/{template_name}  -p PARAMETER=value

     在这个命令行中，进行以下更改：

     • 将 <template-path > 替换为下载的模板文件的路径。
     • 根据需要，使用多个 -p PARAMETER=value 对来设置所需的参数。

流程

1. 设置以下参数：

   • 凭证 secret (CREDENTIALS_SECRET)：包含管理用户凭证的 secret 名称，如 第 7.5 节 “为管理用户创建 secret” 中创建。
   • 应用名称 (APPLICATION_NAME)：OpenShift 应用的名称。它用于 Business Central Monitoring 和 KIE 服务器的默认 URL。OpenShift 使用应用程序名称来创建单独的一组部署配置、服务、路由、标签和工件。
   • ImageStream Namespace (IMAGE_STREAM_NAMESPACE)：镜像流可用的命名空间。如果 OpenShift 环境中已存在镜像流（请参阅 第 7.1 节 “确保镜像流和镜像 registry 的可用性”），则命名空间为 openshift。如果您已安装镜像流文件，则命名空间是 OpenShift 项目的名称。

流程

1. 设置以下参数：

   • Name of the Business Central service (BUSINESS_CENTRAL_SERVICE): Business Central Monitoring 的 OpenShift 服务名称。

流程

1. 设置以下参数：

   • RH-SSO URL (SSO_URL): RH-SSO 的 URL。
   • RH-SSO Realm 名称 (SSO_REALM)：红帽流程自动化管理器的 RH-SSO 域。
   • RH-SSO 禁用 SSL 证书验证 (SSO_DISABLE_SSL_CERTIFICATE_VALIDATION):如果您的 RH-SSO 安装不使用有效的 HTTPS 证书，则设置为 true。

2. 完成以下流程之一：

   1. 如果您在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端，请在模板中设置以下参数：

      • Business Central Monitoring RH-SSO Client name (BUSINESS_CENTRAL_SSO_CLIENT): Business Central Monitoring 的 RH-SSO 客户端名称。

   2. 要在 RH-SSO 中为 Red Hat Process Automation Manager 创建客户端，请在模板中设置以下参数：

      • RH-SSO Realm Admin Username (SSO_USERNAME)和 RH-SSO Realm Admin Password (SSO_PASSWORD)：红帽流程自动化管理器的 RH-SSO 域的用户名和密码。您必须提供此用户名和密码来创建所需的客户端。

流程

1. 设置模板的 AUTH_LDAP* 参数。这些参数使用红帽 JBoss EAP 的 Elytron 子系统配置 LDAP 身份验证。有关在 LDAP 中使用 Red Hat JBoss EAP 的 Elytron 子系统的更多信息，请参阅使用 基于 LDAP 的身份存储配置身份验证。

   注意

   如果要启用 LDAP 故障转移，您可以在 AUTH_LDAP_URL 参数中放置设置或更多 LDAP 服务器地址，用空格分隔。

   如果 LDAP 服务器没有定义部署所需的所有角色，您可以将 LDAP 组映射到 Red Hat Process Automation Manager 角色。要启用 LDAP 角色映射，请设置以下参数：

   • RoleMapping rolesProperties 文件路径或一行角色 (AUTH_ROLE_MAPPER_ROLES_PROPERTIES)：定义角色映射的文件的完全限定路径名称，如 /opt/eap/standalone/configuration/rolemapping.properties。您必须提供此文件，并在所有适用的部署配置中的这个路径中挂载该文件 ; 有关说明，请参阅 第 13.3 节 “（可选）提供 LDAP 角色映射文件”。

     或者，您可以使用 role=role1,role2;another-role=role2 pattern （如 admins=kie-server,rest-all,admin;developers=kie-server,rest-all,admin;developers=kie-server,rest-all ）在此属性中输入角色映射设置。

   • 角色映射程序 Keep Mapped (AUTH_LDAP_MAPPER_KEEP_MAPPED)：如果设为 true，则 LDAP 服务器上定义的映射角色和角色都设置为 用户应用角色；如果设为 false，则映射的角色将替换 LDAP 服务器上定义的角色。默认设置为 false。
   • 角色映射程序 Keep Non-mapped (AUTH_LDAP_MAPPER_KEEP_NON_MAPPED)：如果设为 true，则 LDAP 服务器上定义的角色不是用户应用角色；如果设为 false，则没有映射的角色会被删除。默认设置为 false。

流程

1. 设置以下参数：

   • KIE 服务器外部数据库 驱动程序(KIE_SERVER_EXTERNALDB_DRIVER)：服务器的驱动程序，具体取决于服务器类型：

     • mysql
     • postgresql
     • mariadb
     • mssql
     • db2
     • oracle
     • sisu
   • KIE Server External Database User (KIE_SERVER_EXTERNALDB_USER)和 KIE Server External Database Password (KIE_SERVER_EXTERNALDB_PWD)：外部数据库服务器的用户名和密码

   • KIE Server External Database URL (KIE_SERVER_EXTERNALDB_URL)：外部数据库服务器的 JDBC URL

     注意

     如果您使用 EntrepriseDB Postgres 数据库服务器，请使用以 jdbc:postgresql:// 开头的 URL，而不使用 jdbc:edb://。或者，不要设置 URL，而是设置主机和端口参数。

   • KIE Server External Database Host (KIE_SERVER_EXTERNALDB_SERVICE_HOST)和 KIE Server External Database Port (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 （用于 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 连接检查器类 (KIE_SERVER_EXTERNALDB_CONNECTION_CHECKER): 数据库服务器的 JDBC 连接检查程序类的名称。如果没有此信息，则数据库服务器连接在丢失后无法恢复，例如，如果数据库服务器被重启。
   • JDBC Exception Sorter 类 (KIE_SERVER_EXTERNALDB_EXCEPTION_SORTER)：数据库服务器的 JDBC 异常分类器类的名称。如果没有此信息，则数据库服务器连接在丢失后无法恢复，例如，如果数据库服务器被重启。

2. 如果您为使用外部数据库服务器创建了自定义镜像，如 第 7.10 节 “为外部数据库构建自定义 KIE 服务器扩展镜像” 所述，请设置以下参数：

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

3. 如果您使用 MySQL 版本 8 外部数据库服务器，请启用 mysql_native_password 插件并使用它来进行身份验证。有关此插件的说明，请参阅 MySQL 8.0 Reference Manual 中的 原生可插拔身份验证。

   如果您在 Red Hat OpenShift Container Platform 上使用红帽提供的 MySQL 版本 8 镜像来启用该插件，请将 MYSQL_DEFAULT_AUTHENTICATION_PLUGIN 环境变量设置为 mysql_native_password。

   如果您在启用 mysql_native_password 插件前在 MySQL 版本 8 服务器上创建了用户，则必须在启用插件后更新 mysql-user 表。

流程

1. 从红帽客户门户网站的 Software Downloads 页面下载 rhpam-7.12.0-openshift-templates.zip 产品提供的可交付文件。
2. 提取 rhpam712-prod.yaml 模板文件。
3. 默认情况下，模板包含两个 KIE 服务器。每个服务都使用 pod 中的 PostgreSQL 数据库服务器。要更改 KIE Servers 的数量或使用 pod 或外部数据库服务器中的 MySQL 数据库服务器，请修改模板，如 第 12.2 节 “为固定受管环境修改模板” 所述。

4. 使用以下方法之一开始部署模板：

   • 要使用 OpenShift Web UI，在 OpenShift 应用程序控制台中选择 Add to Project → Import YAML / JSON，然后选择或粘贴 rhpam712-prod.yaml 文件。在 Add Template 窗口中 ，确保选择了模板 并单击 Continue。

   • 要使用 OpenShift 命令行控制台，请准备以下命令行：

     oc new-app -f <template-path>/rhpam712-prod.yaml -p BUSINESS_CENTRAL_HTTPS_SECRET=businesscentral-app-secret -p KIE_SERVER_HTTPS_SECRET=kieserver-app-secret -p PARAMETER=value

     在这个命令行中，进行以下更改：

     • 将 <template-path > 替换为下载的模板文件的路径。
     • 根据需要，使用多个 -p PARAMETER=value 对来设置所需的参数。

流程

1. 设置以下参数：

   • 凭证 secret (CREDENTIALS_SECRET)：包含管理用户凭证的 secret 名称，如 第 7.5 节 “为管理用户创建 secret” 中创建。
   • Business Central Monitoring Server Keystore Secret Name (BUSINESS_CENTRAL_HTTPS_SECRET): Business Central 的机密名称，如 第 7.3 节 “为 Business Central 创建 secret” 中创建。
   • KIE Server Keystore Secret Name (KIE_SERVER_HTTPS_SECRET)：KIE 服务器的 secret 名称，如 第 7.2 节 “为 KIE 服务器创建 secret” 中创建的。
   • Smart Router Keystore Secret Name (KIE_SERVER_ROUTER_HTTPS_SECRET): 智能路由器 secret 的名称，如 第 7.4 节 “为智能路由器创建 secret” 中创建。
   • Business Central 监控服务器证书名称 (BUSINESS_CENTRAL_HTTPS_NAME)：您在 第 7.3 节 “为 Business Central 创建 secret” 中创建的密钥存储中的证书名称。
   • Business Central Monitoring Server Keystore Password (BUSINESS_CENTRAL_HTTPS_PASSWORD)：您在 第 7.3 节 “为 Business Central 创建 secret” 中创建的密钥存储的密码。
   • KIE 服务器证书名称 (KIE_SERVER_HTTPS_NAME)：您在 第 7.2 节 “为 KIE 服务器创建 secret” 中创建的密钥存储中的证书名称。
   • KIE Server Keystore Password (KIE_SERVER_HTTPS_PASSWORD)：您在 第 7.2 节 “为 KIE 服务器创建 secret” 中创建的密钥存储的密码。
   • 智能路由器证书名称 (KIE_SERVER_ROUTER_HTTPS_NAME)：您在 第 7.4 节 “为智能路由器创建 secret” 中创建的密钥存储中的证书名称。
   • Smart Router Keystore Password (KIE_SERVER_ROUTER_HTTPS_PASSWORD)：您在 第 7.4 节 “为智能路由器创建 secret” 中创建的密钥存储的密码。
   • 应用名称 (APPLICATION_NAME)：OpenShift 应用的名称。它用于 Business Central Monitoring 和 KIE 服务器的默认 URL。OpenShift 使用应用程序名称来创建单独的一组部署配置、服务、路由、标签和工件。只要使用不同的应用名称，就可以使用同一模板将多个应用部署到同一项目中。另外，应用程序名称决定了此 KIE Server 实例在 Business Central Monitoring 上加入的服务器配置（服务器模板）的名称。如果要部署多个 KIE 服务器实例，您必须确保每个服务器都有不同的应用程序名称。
   • Maven 存储库 URL (MAVEN_REPO_URL): Maven 存储库的 URL。您必须将要在 KIE 服务器上部署的所有进程(KJAR 文件)上传到此存储库。
   • Maven 存储库 ID (MAVEN_REPO_ID)：Maven 存储库的标识符。默认值为 repo-custom。
   • Maven 存储库用户名 (MAVEN_REPO_USERNAME): Maven 存储库的用户名。
   • Maven 存储库密码 (MAVEN_REPO_PASSWORD): Maven 存储库的密码。
   • KIE Server Mode (KIE_SERVER_MODE): 在 rhpam712-kieserver-*.yaml 模板中，默认值为 PRODUCTION。在 PRODUCTION 模式中，您无法在此 KIE Server 实例上部署 SNAPSHOT 版本 KJAR 工件，且无法更改现有容器中的工件版本。要使用 PRODUCTION 模式 部署新版本，请在同一 KIE 服务器上创建一个新容器。要部署 SNAPSHOT 版本或更改现有容器中的工件版本，请将此参数设置为 DEVELOPMENT。
   • ImageStream Namespace (IMAGE_STREAM_NAMESPACE)：镜像流可用的命名空间。如果 OpenShift 环境中已存在镜像流（请参阅 第 7.1 节 “确保镜像流和镜像 registry 的可用性”），则命名空间为 openshift。如果您已安装镜像流文件，则命名空间是 OpenShift 项目的名称。