将应用程序与 Kamelets 集成

流程

1. 在 OpenShift Container Platform web 控制台中，使用具有集群管理员特权的帐户登录。

2. 创建一个新的 OpenShift 项目：

   1. 在左侧导航菜单中，点击 Home > Project > Create Project。
   2. 输入项目名称，如 my-camel-k-project，然后单击 Create。
3. 在左侧导航菜单中，点 Operators > OperatorHub。
4. 在 Filter by keyword 文本框中，键入 Camel K，然后单击 Red Hat Integration - Camel K Operator 卡。
5. 阅读 Operator 的信息，然后单击 Install。Operator 安装页面将打开。

6. 选择以下订阅设置：

   • 更新频道 & gt; latest
   • Installation Mode > A specific namespace on the cluster > my-camel-k-project

   • 批准策略 & gt; Automatic

     注意

     如果您的环境需要，也可使用 Installation mode > All namespaces on the cluster and Approval Strategy > Manual 设置。

7. 点 Install，然后稍等片刻，直到 Camel K Operator 准备就绪可用。

8. 下载并安装 Camel K CLI 工具：

   1. 在 OpenShift Web 控制台顶部的 Help 菜单（？）中，选择 Command 命令行工具。
   2. 向下滚动到 kamel - Red Hat Integration - Camel K - 命令行界面 部分。
   3. 点击链接下载本地操作系统的二进制文件(Linux、Mac、Windows)。
   4. 在您的系统路径中解压缩并安装 CLI。

   5. 要验证您可以访问 Kamel K CLI，请打开一个命令窗口，然后键入以下内容：

      kamel --help

      此命令显示关于 Camel K CLI 命令的信息。

1. 在终端窗口中，登录您的 OpenShift 集群。

2. 查看可用 Kamelets 列表取决于安装 Camel K 运算符（在特定的命名空间或 cluster-mode 中）：

   • 如果以 cluster-mode 安装 Camel K operator，请使用这个命令查看可用的 Kamelets：

     oc get kamelet -n openshift-operators

   • 如果 Camel K 操作器安装在特定命名空间中：

     1. 打开安装 Camel K 操作器的项目。

        oc project <camelk-project>

        例如，如果在 my-camel-k-project 项目中安装了 Camel K 运算符：

        oc project my-camel-k-project

     2. 运行以下命令：

        oc get kamelets

流程

1. 登录您的 OpenShift 集群。

2. 打开安装 Camel K 操作器的工作项目。如果您以 cluster-mode 中安装 Camel K，它可以供集群上的任何项目使用。

   例如，要打开名为 my-camel-k-project 的现有项目：

   oc project my-camel-k-project

3. 使用以下选项之一创建新的 Kamelet Binding：

   • 使用 kamel bind 命令创建并运行 Kamelet Binding （这个选项对命令行定义比较ducive 的简单 Kamelet Bindings）非常有用。）

   • 创建一个 YAML 文件来定义 Kamelet Binding，然后使用 oc apply 命令运行它（在 Kamelet Binding 配置更复杂时，此选项很有用）。

     使用 kamel bind 命令创建一个新的 Kamelet Binding

     使用以下 kamel bind 语法指定 source 和 sink Kamelets 和任何配置参数：

     kamel bind <kamelet-source> -p “<property>=<property-value>” <kamelet-sink> -p “<property>=<property-value>”

     例如：

     kamel bind coffee-source -p “source.period=5000” log-sink -p "sink.showStreams=true"

     Camel K 运算符生成 KameletBinding 资源，并运行对应的 Camel K 集成。

     使用 YAML 文件创建新的 Kamelet Binding

     1. 在您选择的编辑器中，使用以下结构创建一个 YAML 文件：

        apiVersion: camel.apache.org/v1alpha1
        kind: KameletBinding
        metadata:
          name:
        spec:
          source:
          sink:

     2. 为 Kamelet Binding 添加名称。

        在本例中，名称为 coffee-to-log，因为该绑定将 coffee-source Kamelet 连接到 log-sink Kamelet。

        apiVersion: camel.apache.org/v1alpha1
        kind: KameletBinding
        metadata:
          name: coffee-to-log
        spec:
          source:
          sink:

     3. 指定源 Kamelet （例如，c offee-source），并为 Kamelet 配置任何参数。

        注： 在本例中，参数在 Kamelet Binding 的 YAML 文件中定义。另外，您可以在属性文件、ConfigMap 或 Secret 中配置 Kamelet 参数，如 配置 Kamelet 实例参数 中所述。

        apiVersion: camel.apache.org/v1alpha1
        kind: KameletBinding
        metadata:
          name: coffee-to-log
        spec:
          source:
            ref
              kind: Kamelet
              apiVersion: camel.apache.org/v1alpha1
              name: coffee-source
            properties:
              period: 5000
          sink:

     4. 指定 sink Kamelet （如 log-sink）并为 Kamelet 配置任何参数。使用 log-sink Kamelet 的可选 showStreams 参数显示消息正文。

        apiVersion: camel.apache.org/v1alpha1
        kind: KameletBinding
        metadata:
          name: coffee-to-log
        spec:
          source:
            ref:
              kind: Kamelet
              apiVersion: camel.apache.org/v1alpha1
              name: coffee-source
            properties:
              period: 5000
          sink:
            ref:
              kind: Kamelet
              apiVersion: camel.apache.org/v1alpha1
              name: log-sink
            properties:
              showStreams: true

     5. 保存 YAML 文件（例如，coff ee-to-log.yaml）。

     6. 将 KameletBinding 作为资源添加到 OpenShift 命名空间：

        oc apply -f <kamelet-binding>.yaml

        例如：

        oc apply -f coffee-to-log.yaml

        Camel K 运算符通过使用 KameletBinding 资源生成并运行 Camel K 集成。

4. 查看 Kamelet Binding 的状态：

   oc get kameletbindings

5. 要查看对应集成的状态： oc get integrations

6. 查看输出：

   • 要从命令行查看日志，请打开终端窗口并输入以下命令：

     kamel log <integration-name>

     例如，如果集成名称为 coffee-to-log，使用以下命令：

     kamel log coffee-to-log

   • 查看 OpenShift Web 控制台的日志：

     1. 选择 Workloads > Pods。

     2. 单击 Camel K 集成 pod 的名称，然后单击 Logs。

        您应该看到类似以下示例的 coffee 事件列表：

        INFO  [log-sink-E80C5C904418150-0000000000000001] (Camel (camel-1) thread #0 - timer://tick) {"id":7259,"uid":"a4ecb7c2-05b8-4a49-b0d2-d1e8db5bc5e2","blend_name":"Postmodern Symphony","origin":"Huila, Colombia","variety":"Kona","notes":"delicate, chewy, black currant, red apple, star fruit","intensifier":"balanced"}

7. 要停止集成，请删除 Kamelet Binding：

   oc delete kameletbindings/<kameletbinding-name>

   例如：

   oc delete kameletbindings/coffee-to-log

流程

1. 在编辑器中打开 KameletBinding 文件。

   例如，以下是 coffee-to-log.yaml 文件的内容：

   apiVersion: camel.apache.org/v1alpha1
   kind: KameletBinding
   metadata:
     name: coffee-to-log
   spec:
     source:
       ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: coffee-source
       properties:
         period: 5000
     sink:
       ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: log-sink

2. 在 source 部分上方添加 集成 部分并提供以下 Builder 特征配置属性（根据 predicate-filter-action Kamelet 的要求）：

   apiVersion: camel.apache.org/v1alpha1
   kind: KameletBinding
   metadata:
     name: coffee-to-log
   spec:
     integration:
            traits:
              builder:
                configuration:
                  properties:
                    - "quarkus.arc.unremovable- types=com.fasterxml.jackson.databind.ObjectMapper"
     source:
       ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: coffee-source
       properties:
         period: 5000
     sink:
       ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: log-sink

3. 在 source 和 sink 部分之间添加一个 steps 部分，并定义 action Kamelet。例如：

   apiVersion: camel.apache.org/v1alpha1
   kind: KameletBinding
   metadata:
     name: coffee-to-log
     spec:
       integration:
              traits:
                builder:
                  configuration:
                    properties:
                      - "quarkus.arc.unremovable-types=com.fasterxml.jackson.databind.ObjectMapper"
     source:
       ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: coffee-source
       properties:
         period: 5000
     steps:
     - ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: json-deserialize-action
     - ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: predicate-filter-action
       properties:
         expression: "@.intensifier =~ /.*deep/"
     - ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: json-serialize-action
     sink:
       ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: log-sink

4. 保存您的更改。

5. 使用 oc apply 命令更新 KameletBinding 资源，例如：

   oc apply -f coffee-to-log.yaml

   Camel K operator re-generates 并运行它根据更新的 KameletBinding 资源生成的 CamelK 集成。

6. 查看 Kamelet Binding 的状态：

   oc get kameletbindings

7. 查看其对应集成的状态：

   oc get integrations

8. 查看集成的日志文件输出：

   kamel logs <integration-name>

   例如，如果集成名称为 coffee-to-log ：

   kamel logs coffee-to-log

9. 要停止集成，请删除 Kamelet Binding：

   oc delete kameletbindings/<kameletbinding-name>

   例如：

   oc delete kameletbindings/coffee-to-log

1. 在编辑器中打开 KameletBinding YAML 文件。

2. 在 sink 定义后在 spec 部分添加错误 handler 部分：

   apiVersion: camel.apache.org/v1alpha1
   kind: KameletBinding
   metadata:
     name: example-kamelet-binding
   spec:
     source:
      ...
     sink:
      ...
     errorHandler: ...

   例如，在 coffee-to-log Kamelet Binding 中，通过添加日志错误处理程序指定错误的最大次数：

   apiVersion: camel.apache.org/v1alpha1
   kind: KameletBinding
   metadata:
     name: coffee-to-log
   spec:
     source:
       ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: coffee-source
       properties:
         period: 5000
     sink:
       ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: log-sink
     errorHandler:
       log:
         parameters:
           maximumRedeliveries: 3

3. 保存您的文件。

流程

1. 编辑 Kamelet Binding，将 topic-name-matches-filter-action Kamelet 包含在源和 sink Kamelets 之间的中间步骤。

   通常，您可以使用 kafka-source Kamelet 作为源 Kamelet，并将主题作为所需 主题 参数的值提供。

   在以下 Kamelet Binding 示例中，kafka-source Kamelet 指定 test-topic、test-topic-2 和 test-topic-3 Kafka 主题和 topic-name-matches-filter-action Kamelet 指定过滤 topic-test 主题中的事件数据：

   apiVersion: camel.apache.org/v1alpha1
   kind: KameletBinding
   metadata:
     name: kafka-to-log-by-topic
   spec:
     source:
       ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: kafka-source
       properties:
         bootstrapServers: "broker.url:9092"
         password: "testpassword"
         topic: "test-topic, test-topic-2, test-topic-3"
         user: "testuser"
         securityProtocol: "PLAINTEXT" // only for AMQ streams
   steps:
     - ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: topic-name-matches-filter-action
       properties:
         regex:  "test-topic"
   sink:
       ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: log-sink
       properties:
           showStreams: true

   如果要过滤来自 kafka-source Kamelet 以外的源 Kamelet 的主题，您必须提供 Kafka 主题信息。您可以使用 insert-header-action Kamelet 将 Kafka 主题字段添加为中间步骤，然后再在 Kamelet Binding 中的 topic-name-matches-filter-action 步骤前面添加 Kamelet Binding 所示：

   apiVersion: camel.apache.org/v1alpha1
   kind: KameletBinding
   metadata:
     name: coffee-to-log-by-topic
   spec:
     source:
       ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: coffee-source
       properties:
         period: 5000
   steps:
     - ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: insert-header-action
       properties:
         name:  "KAFKA.topic"
         value:  "test-topic"
     - ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: topic-name-matches-filter-action
       properties:
         regex:  "test-topic"
   sink:
       ref:
         kind: Kamelet
         apiVersion: camel.apache.org/v1alpha1
         name: log-sink
       properties:
         showStreams: true

2. 保存 Kamelet Binding YAML 文件。

流程

1. 登录您的 OpenShift 集群。

2. 打开您要在其中创建集成应用程序的项目。例如：

   oc project camel-k-knative

3. 使用 Knative (kn) CLI 命令创建频道

   kn channel create <channel_name> --type <channel_type>

   例如，要创建一个名为 mychannel 的频道：

   kn channel create mychannel --type messaging.knative.dev:v1:InMemoryChannel

4. 要确认该频道现在存在，请输入以下命令列出所有现有频道：

   kn 频道列表

   您应该在列表中看到您的频道。

流程

1. 登录您的 OpenShift 集群。

2. 打开您要在其中创建集成应用程序的项目。例如：

   oc project camel-k-knative

3. 使用这个 Knative (kn) CLI 命令创建代理：

   kn 代理创建 default

4. 要确认代理现在存在，请输入以下命令列出所有现有代理：

   kn broker list