在 Red Hat Process Automation Manager 中开始使用 Red Hat build of Kogito

流程

1. 在 VS Code IDE 中，选择 Extensions 菜单选项，并搜索 Red Hat Business Automation Bundle for DMN、Harllse 和 test scenario 文件支持。

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

2. 当 Red Hat Business Automation Bundle 扩展出现在 VS Code 中时，选择它并点 Install。
3. 要获得最佳 VS Code 编辑器行为，请在扩展安装完成后，重新加载或关闭并重新启动 VS Code 实例。

流程

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

   手动下载每个 JavaScript 文件 ： 对于这个方法，请按照以下步骤操作：

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

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

      DMN 编辑器的 HTML 页面标记

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

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

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

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

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

      添加 NPM 软件包

      npm install @kie-tools/kie-editors-standalone

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

      导入每个编辑器

      import * as DmnEditor from "@kie-tools/kie-editors-standalone/dist/dmn"
      import * as BpmnEditor from "@kie-tools/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("")
         }
       ]
     ])
   });

   在 editor 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。
   Origin （可选）	仓库的起源。默认值为 window.location.origin。
   资源 （可选）	编辑器的资源映射。例如，这个参数用于为 DMN 编辑器提供包含的模型，或为 BPMN 编辑器提供工作项目定义。映射中的每个条目都包含一个资源名称和一个对象，它由 content -type （文本 或二进制 ）和内容组成（与 初始Content 参数类似）。

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

   表 2.2. 返回的对象方法

   方法	描述
   getContent（）: Promise<string>	返回包含编辑器内容的保证。
   setContent(path: string, content: string): void	设置编辑器的内容。
   getPreview（）: Promise<string>	返回包含当前图表的 SVG 字符串的保证。
   subscribeToContentChanges（callback:(isDirty: boolean)IFL void）:(isDirty: boolean)void	当编辑器中的内容更改并返回用于 unsubscription 的回调时，设置要调用的回调。
   subscribe toContentChanges（callback:(isDirty: boolean)IFL void）: void	当内容在编辑器中更改时，取消订阅传递的回调。
   markAsSaved(): void	重置编辑器状态，这表示已保存编辑器中的内容。另外，它会激活与内容更改相关的订阅回调。
   undo（）: void	在编辑器中取消上次更改。另外，它会激活与内容更改相关的订阅回调。
   redo（）: void	在编辑器中恢复最近一次撤消的更改。另外，它会激活与内容更改相关的订阅回调。
   close（）: void	关闭编辑器。
   getElementPosition(selector: string): Promise<Rect>	提供了一种替代方式，可以在可清空或视频组件中的元素中时扩展标准查询选择器。选择器 参数必须遵循 <targetNamespaces >:::<SELECT > 格式，如 Canvas:::MySquare 或 Video:::PresenterHand。此方法返回一个代表元素位置的 Rect。
   envelopeApi: MessageBusClientApi<KogitoEditorEnvelopeApi>	这是高级编辑器 API。有关高级编辑器 API 的更多信息，请参阅 MessageBusClientApi 和 KogitoEditorEnvelopeApi。

流程

1. 在命令终端中，导航到要存储新项目的本地文件夹。

2. 输入以下命令使用 starters 或 addons 属性来生成项目：

   • 要使用 starters 属性 生成 项目，请输入以下命令：

     $ mvn archetype:generate \
         -DarchetypeGroupId=org.kie.kogito \
         -DarchetypeArtifactId=kogito-springboot-archetype \
         -DgroupId=org.acme -DartifactId=sample-kogito \
         -DarchetypeVersion=1.11.0.Final \
         -Dversion=1.0-SNAPSHOT
         -Dstarters=decisions

     新项目包含运行决策微服务所需的依赖项。您可以使用以逗号分隔的列表组合多个 Spring Boot starters，如 starters=decisions,rules。

   • 要使用 addons 属性生成包含 Prometheus 监控的项目，请输入以下命令：

     $ mvn archetype:generate \
         -DarchetypeGroupId=org.kie.kogito \
         -DarchetypeArtifactId=kogito-springboot-archetype \
         -DgroupId=org.acme -DartifactId=sample-kogito \
         -DarchetypeVersion=1.11.0.Final \
         -Dversion=1.0-SNAPSHOT
         -Dstarters=descisions
         -Daddons=monitoring-prometheus,persistence-infinispan

     注意

     当您将附加组件传递给属性时，附加组件名称不需要 kogito-addons-springboot 前缀。另外，您还可以组合 附加组件 和 starters 属性来自定义项目。

3. 打开或导入 IDE 中的项目以查看内容。

流程

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 的人被归类为dult。规则文件还声明该规则属于规则单元 PersonRules。构建项目时，将生成规则单元并将其与 DRL 文件关联。

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

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

   使用传统表示法的 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. 在类路径中创建名为 META-INF/services/org.kie.kogito.add-on.cloudevents.message.MessagePayloadDecorator 的文件。
2. 打开 文件。
3. 在文件中输入您的实施类的完整名称。

4. 保存该文件。

   MessagePayloadDecoratorProvider 在应用程序启动时加载文件，并将该文件添加到 decoration 链中。当红帽构建的 Kogito 调用 MessagePayloadDecoratorProvider#decorate 时，您的实现是分离算法的一部分。

5. 要使用事件附加组件，请将以下代码添加到项目的 pom.xml 文件中：

   {QAURKUS} 的事件小附加组件

   <dependency>
     <groupId>org.kie.kogito</groupId>
     <artifactId>kogito-addons-quarkus-events-smallrye</artifactId>
     <version>1.15</version>
   </dependency>

   {QAURKUS} 的事件决策附加组件

   <dependency>
     <groupId>org.kie.kogito</groupId>
     <artifactId>kogito-addons-events-decisions</artifactId>
     <version>1.15</version>
   </dependency>

   为 Spring Boot 的事件 Kafka 附加组件

   <dependency>
     <groupId>org.kie.kogito</groupId>
     <artifactId>kogito-addons-springboot-events-kafka</artifactId>
     <version>1.15</version>
   </dependency>

   Spring Boot 的事件决策附加组件

   <dependency>
     <groupId>org.kie.kogito</groupId>
     <artifactId>kogito-addons-springboot-events-decisions</artifactId>
     <version>1.15</version>
   </dependency>

流程

1. 进入 Operators → Installed Operators 并选择 RHPAM Kogito Operator。
2. 要在 operator 页面上创建 Red Hat build of Kogito build 定义，请选择 Kogito Build 选项卡，然后点击 Create KogitoBuild。

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

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

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

   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

   带有红帽构建的 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 mirror 服务，并在 Red Hat build of Kogito 构建定义中指定 Maven mirror URL 来缩短构建时间：

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

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

4. 定义应用程序数据后，点 Create 生成 Red Hat build of Kogito 构建。

   您的应用程序在 红帽构建的 KogitoBuilds 页面中列出。您可以选择应用程序名称来查看或修改应用程序设置和 YAML 详情。

5. 要创建 Red Hat build of Kogito 微服务定义，请在 operator 页面中选择 Kogito Runtime 选项卡，然后点击 Create KogitoRuntime。

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

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

   带有红帽构建的 Kogito 微服务构建的 Red Hat build 的 YAML 定义示例

   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 生成 Red Hat build of 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. 部署完 Red Hat build of Kogito microservice 后，在 web 控制台的左侧菜单中，转至 Networking → Routes 以查看对部署的应用程序的访问链接。

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

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

流程

1. 本地构建应用程序。
2. 进入 Operators → Installed Operators 并选择 RHPAM Kogito Operator。
3. 要在 operator 页面上创建 Red Hat build of Kogito build 定义，请选择 Kogito Build 选项卡，然后点击 Create KogitoBuild。

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

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

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

   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

   带有红帽构建的 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 生成 Red Hat build of Kogito 构建。

   您的应用程序在 红帽构建的 KogitoBuilds 页面中列出。您可以选择应用程序名称来查看或修改应用程序设置和 YAML 详情。

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

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

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

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

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

   带有红帽构建的 Kogito 微服务构建的 Red Hat build 的 YAML 定义示例

   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 生成 Red Hat build of Kogito 微服务。

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

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

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

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

12. 部署完 Red Hat build of Kogito microservice 后，在 web 控制台的左侧菜单中，转至 Networking → Routes 以查看对部署的应用程序的访问链接。

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

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

流程

1. 本地构建应用程序。

2. 在项目根目录中创建 Containerfile 并包含以下内容：

   Red Hat build of Quarkus 应用程序的 Containerfile 示例

   FROM registry.redhat.io/rhpam-7/rhpam-kogito-runtime-jvm-rhel8:7.13.5
   
   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.13.5
   
   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>

   在上一命令中，final-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. 要创建 Red Hat build of Kogito 微服务定义，请在 operator 页面中选择 Kogito Runtime 选项卡，然后点击 Create KogitoRuntime。

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

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

   带有红帽构建的 Kogito 微服务构建的 Red Hat build 的 YAML 定义示例

   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 生成 Red Hat build of Kogito 微服务。

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

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

11. 部署完 Red Hat build of Kogito microservice 后，在 web 控制台的左侧菜单中，转至 Networking → Routes 以查看对部署的应用程序的访问链接。

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

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

流程

1. 进入 Operators → Installed Operators 并选择 RHPAM Kogito Operator。
2. 要在 operator 页面上创建 Red Hat build of Kogito build 定义，请选择 Kogito Build 选项卡，然后点击 Create KogitoBuild。

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

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

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

   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

   带有红帽构建的 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 mirror 服务，并在 Red Hat build of Kogito 构建定义中指定 Maven mirror URL 来缩短构建时间：

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

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

4. 定义应用程序数据后，点 Create 生成 Red Hat build of Kogito 构建。

   您的应用程序在 红帽构建的 KogitoBuilds 页面中列出。您可以选择应用程序名称来查看或修改应用程序设置和 YAML 详情。

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

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

   • file-asset-path 是您要上传的文件内容的路径。
   • namespace 是创建 KogitoBuild 的命名空间。
6. 要创建 Red Hat build of Kogito 微服务定义，请在 operator 页面中选择 Kogito Runtime 选项卡，然后点击 Create KogitoRuntime。

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

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

   带有红帽构建的 Kogito 微服务构建的 Red Hat build 的 YAML 定义示例

   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 生成 Red Hat build of Kogito 微服务。

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

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

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

   注意

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

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

11. 部署完 Red Hat build of Kogito microservice 后，在 web 控制台的左侧菜单中，转至 Networking → Routes 以查看对部署的应用程序的访问链接。

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

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

流程

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

1. 使用 KIE 服务器 API 将现有外部应用程序从通用 KIE 服务器 API 迁移到特定的 DMN REST 端点。
2. 将 KIE 服务器上部署的 KJAR 迁移至 Red Hat build of Kogito 微服务。
3. 使用 Red Hat OpenShift Container Platform 部署红帽 Kogito 微服务构建。
4. 重新连接外部应用程序，并将 REST API 消耗从特定的 DMN REST 端点迁移到 Red Hat build of Kogito 部署。

流程

1. 如果您在外部应用程序中使用 REST 端点，请使用 GET /server/containers/{containerId}/dmn/openapi.json(|.yaml) 端点检索 KJAR 的 Swagger 或 OAS 规格文件。

   有关特定 DMN 模型的 REST 端点的更多信息，请参阅特定 DMN 模型的 REST 端点。

2. 在您的外部应用程序中，选择要与决策服务交互的 Java 或 JDK 库。您可以使用特定 KJAR 的 REST 端点与决策服务交互。

流程

1. 为您的红帽构建 Kogito 微服务创建一个 Maven 项目。

   有关创建 Maven 项目的步骤，请参阅为红帽构建 Kogito 微服务创建 Maven 项目。

   Maven 项目创建 Kogito 工件。

2. 将 KJAR 的 src/main/resources 文件夹中的 DMN 模型复制到 Kogito 工件的 src/main/resources 文件夹。

3. 将 KJAR 的 src/test/resources 文件夹的测试场景复制到 Kogito 工件的 src/test/resources 文件夹。

   重要

   您需要在项目 pom.xml 文件中导入 Kogito 依赖关系的 Kogito 依赖项，并使用 KIE 服务器 REST API 创建 JUnit 激活者。如需更多信息，请参阅使用 测试场景 测试决策服务。

4. 运行以下命令，并确保测试场景正在为指定的非出口测试运行。

   mvn clean install

   运行 Red Hat build of Kogito 应用程序后，您可以检索 Swagger 或 OAS 规格文件。Swagger 或 OAS 规格提供与 REST 端点相同的信息，以及以下实施详情：

   • 提供 API 的服务器的基本 URL
   • 引用架构名称

   当外部应用程序重新路由到新 URL 时，您可以使用提供的实现详情。

1. 将 KIE 服务器上部署的 KJAR 迁移至 Red Hat build of Kogito 微服务。
2. 使用 Red Hat OpenShift Container Platform 部署红帽 Kogito 微服务构建。
3. 将 KIE 服务器上的客户端 PMML API 中的外部应用程序修改为 Red Hat 构建的 Kogito 部署的 REST API。

流程

1. 为您的红帽构建 Kogito 微服务创建一个 Maven 项目。

   有关创建 Maven 项目的步骤，请参阅为红帽构建 Kogito 微服务创建 Maven 项目。

   Maven 项目创建 Kogito 工件。

2. 将 KJAR 的 src/main/resources 文件夹下的 PMML 型号复制到 Kogito 工件的 src/main/resources 文件夹。

3. 运行以下命令执行 Red Hat build of Kogito 应用程序：

   mvn clean install

   运行 Red Hat build of Kogito 应用程序后，您可以检索 Swagger 或 OAS 规格文件。Swagger 或 OAS 规格提供与 REST 端点相同的信息，以及以下实施详情：

   • 提供 API 的服务器的基本 URL
   • 引用架构名称

   当外部应用程序重新路由到新 URL 时，您可以使用提供的实现详情。

流程

1. 删除 KIE 服务器客户端 API 的所有用法，并将其替换为 HTTP 通信。以下是非 Java 请求的示例：

   

2. 确保外部应用中使用任何 HTTP 客户端 Java 库来创建类似的调用并解析结果。

   以下是 Java 11 HTTP 客户端和 Gson 将输入数据转换为 JSON 的示例：

   
   注意

   所有作为参数的值所需的参数都嵌入到调用的 URL 中。