在 Red Hat Process Automation Manager 中使用红帽构建的 Kogito

流程

1. 在 VSCode IDE 中，选择 Extensions 菜单选项，并搜索 Red Hat Business Automation Bundle for DMN、Tist 和 test 场景文件支持。

   对于 DMN 或 the 文件支持，您也可以搜索单独的 DMN Editor 或 Tailoring Editor 扩展。

2. 当 Red Hat Business Automation Bundle 扩展出现在 VSCode 中时，选择它并单击 Install。
3. 对于最佳 VSCode 编辑器行为，请在完成扩展安装后，重新加载或关闭和重新启动 VSCode 实例。

�程

1. 使用以下方法之一安装独立编辑器：

   手动下载每个 JavaScript 文件 ：对于此方法，请按照以下步骤执行：

   1. 下载 JavaScript 文件。
   2. 将下载的 Javascript 文件添加到托管应用程序中。

   3. 将以下 &lt ;script& gt; 标签添加到 HTML 页面中：

      DMN 编辑器的 HTML 页面的脚本标签

      <script src="https://<YOUR_PAGE>/dmn/index.js"></script>

      您的 HTML 页面的脚本标签

      <script src="https://<YOUR_PAGE>/bpmn/index.js"></script>

   使用 NPM 软件包 ：对于这个方法，请按照以下步骤执行：

   1. 在您的 package.json 文件中添加 NPM 软件包：

      添加 NPM 软件包

      npm install @redhat/kogito-tooling-kie-editors-standalone

   2. 将每个编辑器库导入到您的 TypeScript 文件中：

      导入每个编辑器

      import * as DmnEditor from "@redhat/kogito-tooling-kie-editors-standalone/dist/dmn"
      import * as BpmnEditor from "@redhat/kogito-tooling-kie-editors-standalone/dist/bpmn"

2. 安装独立编辑器后，使用提供的编辑器 API 打开所需的编辑器，如下例所示来打开 DMN 编辑器。每个编辑器的 API 相同。

   打开 DMN 独立编辑器

   const editor = DmnEditor.open({
     container: document.getElementById("dmn-editor-container"),
     initialContent: Promise.resolve(""),
     readOnly: false,
     origin: "",
     resources: new Map([
       [
         "MyIncludedModel.dmn",
         {
           contentType: "text",
           content: Promise.resolve("")
         }
       ]
     ])
   });

   在编辑器 API 中使用以下参数：

   表 2.1. 参数示例

   �数	�述
   container	附加编辑器的 HTML 元素。
   initialContent	承诺 DMN 模型内容。这个参数可以为空，如下例所示： Promise.resolve("") Promise.resolve("<DIAGRAM_CONTENT_DIRECTLY_HERE>") fetch("MyDmnModel.dmn").then(content ⇒ content.text())
   ReadOnly （可选）	允许您在编辑器中允许更改。设置为 false （默认）以允许编辑器中的只读模式的内容编辑和 true。
   原始 （可选）	存储库的来源。默认值为 window.location.origin。
   资源 （可选）	编辑器的资源映射。例如，此参数用于为 DMN 编辑器提供包含的型号，或为 the 编辑器提供工作项目定义。映射中的每个条目都包含一个资源名称，以及一个由 content-type (text 或 binary) 和 content (与 initialContent 参数类似) 组成的对象。

   返回的对象包含操作编辑器所需的方法。

   表 2.2. 返回的对象方法

   方法	�述
   getContent(): Promise<string>	返回包含编辑器内容的承诺。
   setContent(content: string): void	设置编辑器的内容。
   getPreview(): Promise<string>	返回包含当前图的 SVG 字符串的承诺。
   subscribeToContentChanges （callback: (isDirty: boolean) void void: (isDirty: boolean) void void	设置在编辑器中内容更改时调用的回调，并返回相同的回调来取消订阅。
   unsubscribeToContentChanges (callback: (isDirty: boolean) rhcs void): void	当内容在编辑器中更改时，取消订阅传递的回调。
   markAsSaved(): void	重置编辑器状态，表示保存编辑器中的内容。另外，它还激活与内容更改相关的订阅回调。
   undo(): void	撤销编辑器中的最后更改。另外，它还激活与内容更改相关的订阅回调。
   redo(): void	在编辑器中更改最后的未撤消更改。另外，它还激活与内容更改相关的订阅回调。
   close(): void	关闭编辑器。
   getElementPosition (selector: string): Promise<Rect>	提供当元素位于 canvas 或视频组件内时扩展标准查询选择器的替代选择。选择器 参数必须遵循 < PROVIDER>:::<SELECT > 格式，如 Canvas:::MySquare 或 Video:::PresenterHand。此方法返回一个代表元素位置的 Rect。
   envelopeApi: MessageBusClientApi<KogitoEditorEnvelopeApi>	这是一个高级编辑器 API。有关高级编辑器 API 的更多信息，请参阅 MessageBusClientApi 和 KogitoEditorEnvelopeApi。

流程

1. 在示例项目的 src/main/resources 文件夹中，而不是使用 DMN 文件，添加以下 PersonRules.drl 文件：

   PersonRules DRL 文件示例

   package org.acme
   unit PersonRules;
   
   import org.acme.Person;
   
   rule isAdult
   	when
   		$person: /person[ age > 18 ]
   	then
       modify($person) {
       	setAdult(true)
       };
   	end
   
   	query persons
   		$p : /person[ adult ]
   		end

   这个示例规则决定了任何超过 18 的用户都被归类为 adult。规则文件还声明该规则属于规则单元 PersonRules。构建项目时，将生成规则单元并与 DRL 文件相关联。

   规则还使用 OOPath 表示法定义条件。OOPath 是 XPath 的面向对象的语法扩展，用于在处理集合和过滤限制的同时通过相关元素导航。

   您还可以使用传统规则模式语法以更明确的形式重写相同的规则条件，如下例所示：

   使用传统表示法的 PersonRules DRL 文件示例

   package org.acme
   unit PersonRules;
   
   import org.acme.Person;
   
   rule isAdult
   	when
   		$person: Person(age > 18) from person
   	then
       modify($person) {
       	setAdult(true)
       };
   	end
   
   	query persons
   		$p : /person[ adult ]
   		end

流程

1. 进入 Operators → Installed Operators 并选择 RHPAM Kogito Operator。
2. 要创建红帽构建的 Kogito 构建定义，请在 operator 页面中选择 Kogito Build 选项卡，再点 Create KogitoBuild。

3. 在应用程序窗口中，使用 Form View 或 YAML View 来配置构建定义。

   至少，定义以下示例 YAML 文件中显示的应用程序配置：

   红帽构建的 Quarkus 应用程序的 YAML 定义示例，红帽构建的 Kogito 构建

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-quarkus  # Application name
   spec:
     type: RemoteSource
     gitSource:
       uri: 'https://github.com/kiegroup/kogito-examples'  # Git repository containing application (uses default branch)
       contextDir: dmn-quarkus-example  # Git folder location of application

   红帽构建的 Kogito 构建的 Spring Boot 应用程序的 YAML 定义示例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot
     type: RemoteSource
     gitSource:
       uri: 'https://github.com/kiegroup/kogito-examples'  # Git repository containing application (uses default branch)
       contextDir: dmn-springboot-example  # Git folder location of application

   注意

   如果您配置了内部 Maven 存储库，您可以将其用作 Maven 镜像服务，并在 Red Hat build of Kogito 构建定义中指定 Maven 镜像 URL 以大大缩短构建时间：

   spec:
     mavenMirrorURL: http://nexus3-nexus.apps-crc.testing/repository/maven-public/

   有关内部 Maven 存储库的更多信息，请参阅 Apache Maven 文档。

4. 在定义了应用程序数据后，点 Create 生成红帽构建的 Kogito 构建。

   您的应用程序列在 Red Hat build of KogitoBuilds 页面中。您可以选择应用程序名称来查看或修改应用程序设置和 YAML 详情。

5. 要创建红帽构建的 Kogito 微服务定义，请在 operator 页面中选择 Kogito Runtime 选项卡，再点 Create KogitoRuntime。

6. 在应用程序窗口中，使用 Form View 或 YAML View 来配置微服务定义。

   至少，定义以下示例 YAML 文件中显示的应用程序配置：

   红帽构建的 Quarkus 应用程序的 YAML 定义示例，红帽构建的 Kogito 微服务

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-quarkus  # Application name

   红帽构建的 Kogito 微服务的 Spring Boot 应用程序的 YAML 定义示例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot

   注意

   在本例中，应用程序从 Git 构建，并使用 KogitoRuntime 部署。您必须确保应用程序名称在 KogitoBuild 和 KogitoRuntime 中相同。

7. 在定义了应用程序数据后，点 Create 生成红帽构建的 Kogito 微服务。

   您的应用程序在红帽构建的 Kogito 微服务页面中列出。您可以选择应用程序名称来查看或修改应用程序设置以及 YAML 文件的内容。

8. 在 Web 控制台的左侧菜单中，进入 Builds → Builds 来查看应用程序构建的状态。

   您可以选择特定的构建来查看构建详情。

   注意

   对于您为 OpenShift 部署创建的 Kogito 微服务的每个红帽构建，在 web 控制台的 Builds 页面中生成并列出两个构建：传统的运行时构建和 Source-to-Image (S2I)构建，后缀为 -builder。S2I 机制在 OpenShift 构建中构建应用程序，然后将构建的应用传递给下一个 OpenShift 构建，以打包到运行时容器镜像中。红帽构建的 Kogito S2I 构建配置还允许您直接从 OpenShift 平台上的 Git 存储库构建项目。

9. 应用程序构建完成后，进入 Workloads → Deployments 来查看应用程序部署、Pod 状态和其他详情。

10. 部署红帽构建的 Kogito 微服务后，在 web 控制台的左侧菜单中，进入 Networking → Routes 以查看部署的应用程序的访问链接。

    您可以选择应用程序名称来查看或修改路由设置。

    利用应用程序路由，您可以根据需要将红帽构建的 Kogito 微服务与自动化解决方案集成。

流程

1. 在本地构建应用程序。
2. 进入 Operators → Installed Operators 并选择 RHPAM Kogito Operator。
3. 要创建红帽构建的 Kogito 构建定义，请在 operator 页面中选择 Kogito Build 选项卡，再点 Create KogitoBuild。

4. 在应用程序窗口中，使用 Form View 或 YAML View 来配置构建定义。

   至少，定义以下示例 YAML 文件中显示的应用程序配置：

   红帽构建的 Quarkus 应用程序的 YAML 定义示例，红帽构建的 Kogito 构建

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-quarkus  # Application name
   spec:
     type: Binary

   红帽构建的 Kogito 构建的 Spring Boot 应用程序的 YAML 定义示例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot
     type: Binary

5. 在定义了应用程序数据后，点 Create 生成红帽构建的 Kogito 构建。

   您的应用程序列在 Red Hat build of KogitoBuilds 页面中。您可以选择应用程序名称来查看或修改应用程序设置和 YAML 详情。

6. 使用以下命令上传构建的二进制文件：

   $ oc start-build example-quarkus --from-dir=target/ -n namespace

   • from-dir 等于 构建应用程序的目标文件夹路径。
   • namespace 是创建 KogitoBuild 的命名空间。
7. 要创建红帽构建的 Kogito 微服务定义，请在 operator 页面中选择 Kogito Runtime 选项卡，再点 Create KogitoRuntime。

8. 在应用程序窗口中，使用 Form View 或 YAML View 来配置微服务定义。

   至少，定义以下示例 YAML 文件中显示的应用程序配置：

   红帽构建的 Quarkus 应用程序的 YAML 定义示例，红帽构建的 Kogito 微服务

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-quarkus  # Application name

   红帽构建的 Kogito 微服务的 Spring Boot 应用程序的 YAML 定义示例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot

   注意

   在这种情况下，应用程序在本地构建并使用 KogitoRuntime 部署。您必须确保应用程序名称在 KogitoBuild 和 KogitoRuntime 中相同。

9. 在定义了应用程序数据后，点 Create 生成红帽构建的 Kogito 微服务。

   您的应用程序在红帽构建的 Kogito 微服务页面中列出。您可以选择应用程序名称来查看或修改应用程序设置以及 YAML 文件的内容。

10. 在 Web 控制台的左侧菜单中，进入 Builds → Builds 来查看应用程序构建的状态。

    您可以选择特定的构建来查看构建详情。

11. 应用程序构建完成后，进入 Workloads → Deployments 来查看应用程序部署、Pod 状态和其他详情。

12. 部署红帽构建的 Kogito 微服务后，在 web 控制台的左侧菜单中，进入 Networking → Routes 以查看部署的应用程序的访问链接。

    您可以选择应用程序名称来查看或修改路由设置。

    利用应用程序路由，您可以根据需要将红帽构建的 Kogito 微服务与自动化解决方案集成。

流程

1. 在本地构建应用程序。

2. 在项目根文件夹中创建 Containerfile，其内容如下：

   红帽构建的 Quarkus 应用程序的 Containerfile 示例

   FROM registry.redhat.io/rhpam-7/rhpam-kogito-runtime-jvm-rhel8:7.11.0
   
   ENV RUNTIME_TYPE quarkus
   
   COPY target/quarkus-app/lib/ $KOGITO_HOME/bin/lib/
   COPY target/quarkus-app/*.jar $KOGITO_HOME/bin
   COPY target/quarkus-app/app/ $KOGITO_HOME/bin/app/
   COPY target/quarkus-app/quarkus/ $KOGITO_HOME/bin/quarkus/

   Spring Boot 应用程序的 Containerfile 示例

   FROM registry.redhat.io/rhpam-7/rhpam-kogito-runtime-jvm-rhel8:7.11.0
   
   ENV RUNTIME_TYPE springboot
   
   COPY target/<application-jar-file> $KOGITO_HOME/bin

   • application-jar-file 是应用的 JAR 文件的名称。

3. 使用以下命令构建红帽构建的 Kogito 镜像：

   podman build --tag <final-image-name> -f <Container-file>

   在上一命令中，last -image-name 是 Red Hat build of Kogito 镜像的名称，Container-file 是您上一步中创建的 Containerfile 的名称。

4. 另外，使用以下命令测试构建的镜像：

   podman run --rm -it -p 8080:8080 <final-image-name>

5. 使用以下命令将构建的 Red Hat build of Kogito 镜像推送到镜像 registry：

   podman push <final-image-name>

6. 进入 Operators → Installed Operators 并选择 RHPAM Kogito Operator。
7. 要创建红帽构建的 Kogito 微服务定义，请在 operator 页面中选择 Kogito Runtime 选项卡，再点 Create KogitoRuntime。

8. 在应用程序窗口中，使用 Form View 或 YAML View 来配置微服务定义。

   至少，定义以下示例 YAML 文件中显示的应用程序配置：

   红帽构建的 Quarkus 应用程序的 YAML 定义示例，红帽构建的 Kogito 微服务

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime # Application type
   metadata:
     name: example-quarkus # Application name
   spec:
     image: <final-image-name> # Kogito image name
     insecureImageRegistry: true # Can be omitted when image is pushed into secured registry with valid certificate

   红帽构建的 Kogito 微服务的 Spring Boot 应用程序的 YAML 定义示例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime # Application type
   metadata:
     name: example-springboot # Application name
   spec:
     image: <final-image-name> # Kogito image name
     insecureImageRegistry: true # Can be omitted when image is pushed into secured registry with valid certificate
     runtime: springboot

9. 在定义了应用程序数据后，点 Create 生成红帽构建的 Kogito 微服务。

   您的应用程序在红帽构建的 Kogito 微服务页面中列出。您可以选择应用程序名称来查看或修改应用程序设置以及 YAML 文件的内容。

10. 应用程序构建完成后，进入 Workloads → Deployments 来查看应用程序部署、Pod 状态和其他详情。

11. 部署红帽构建的 Kogito 微服务后，在 web 控制台的左侧菜单中，进入 Networking → Routes 以查看部署的应用程序的访问链接。

    您可以选择应用程序名称来查看或修改路由设置。

    利用应用程序路由，您可以根据需要将红帽构建的 Kogito 微服务与自动化解决方案集成。

流程

1. 进入 Operators → Installed Operators 并选择 RHPAM Kogito Operator。
2. 要创建红帽构建的 Kogito 构建定义，请在 operator 页面中选择 Kogito Build 选项卡，再点 Create KogitoBuild。

3. 在应用程序窗口中，使用 Form View 或 YAML View 来配置构建定义。

   至少，定义以下示例 YAML 文件中显示的应用程序配置：

   红帽构建的 Quarkus 应用程序的 YAML 定义示例，红帽构建的 Kogito 构建

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-quarkus  # Application name
   spec:
     type: LocalSource

   红帽构建的 Kogito 构建的 Spring Boot 应用程序的 YAML 定义示例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this service
   kind: KogitoBuild  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot
     type: LocalSource

   注意

   如果您配置了内部 Maven 存储库，您可以将其用作 Maven 镜像服务，并在 Red Hat build of Kogito 构建定义中指定 Maven 镜像 URL 以大大缩短构建时间：

   spec:
     mavenMirrorURL: http://nexus3-nexus.apps-crc.testing/repository/maven-public/

   有关内部 Maven 存储库的更多信息，请参阅 Apache Maven 文档。

4. 在定义了应用程序数据后，点 Create 生成红帽构建的 Kogito 构建。

   您的应用程序列在 Red Hat build of KogitoBuilds 页面中。您可以选择应用程序名称来查看或修改应用程序设置和 YAML 详情。

5. 使用以下命令上传文件资产：

   $ oc start-build example-quarkus-builder --from-file=<file-asset-path> -n namespace

   • file-asset-path 是您要上传的文件资产的路径。
   • namespace 是创建 KogitoBuild 的命名空间。
6. 要创建红帽构建的 Kogito 微服务定义，请在 operator 页面中选择 Kogito Runtime 选项卡，再点 Create KogitoRuntime。

7. 在应用程序窗口中，使用 Form View 或 YAML View 来配置微服务定义。

   至少，定义以下示例 YAML 文件中显示的应用程序配置：

   红帽构建的 Quarkus 应用程序的 YAML 定义示例，红帽构建的 Kogito 微服务

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-quarkus  # Application name

   红帽构建的 Kogito 微服务的 Spring Boot 应用程序的 YAML 定义示例

   apiVersion: rhpam.kiegroup.org/v1 # Red Hat build of Kogito API for this microservice
   kind: KogitoRuntime  # Application type
   metadata:
     name: example-springboot  # Application name
   spec:
     runtime: springboot

   注意

   在这种情况下，应用程序从文件构建，并使用 KogitoRuntime 部署。您必须确保应用程序名称在 KogitoBuild 和 KogitoRuntime 中相同。

8. 在定义了应用程序数据后，点 Create 生成红帽构建的 Kogito 微服务。

   您的应用程序在红帽构建的 Kogito 微服务页面中列出。您可以选择应用程序名称来查看或修改应用程序设置以及 YAML 文件的内容。

9. 在 Web 控制台的左侧菜单中，进入 Builds → Builds 来查看应用程序构建的状态。

   您可以选择特定的构建来查看构建详情。

   注意

   对于您为 OpenShift 部署创建的 Kogito 微服务的每个红帽构建，在 web 控制台的 Builds 页面中生成并列出两个构建：传统的运行时构建和 Source-to-Image (S2I)构建，后缀为 -builder。S2I 机制在 OpenShift 构建中构建应用程序，然后将构建的应用传递给下一个 OpenShift 构建，以打包到运行时容器镜像中。

10. 应用程序构建完成后，进入 Workloads → Deployments 来查看应用程序部署、Pod 状态和其他详情。

11. 部署红帽构建的 Kogito 微服务后，在 web 控制台的左侧菜单中，进入 Networking → Routes 以查看部署的应用程序的访问链接。

    您可以选择应用程序名称来查看或修改路由设置。

    利用应用程序路由，您可以根据需要将红帽构建的 Kogito 微服务与自动化解决方案集成。

流程

1. 在项目的 KogitoRuntime YAML 文件中定义探测，如下例所示：