红帽构建的 Apache Camel for Quarkus 的 kamelets 指南

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

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

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

     oc get kamelet -n openshift-operators

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

     1. 打开安装 Camel K operator 的项目。

        oc project <camelk-project>

        例如，如果 Camel K 操作器安装在 my-camel-k-project 项目中：

        oc project my-camel-k-project

     2. 运行以下命令：

        oc get kamelets

流程

1. 登录到您的 OpenShift 集群。

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

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

   oc project my-camel-k-project

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

   • 使用 kamel bind 命令创建并运行 Kamelet Binding （此选项对于命令行定义是 conducive 的简单 Kamelet Bindings 非常有用）

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

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

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

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

     Copy to Clipboard

     例如：

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

     Copy to Clipboard

     Camel K operator 生成一个 KameletBinding 资源，并运行对应的 Camel K 集成。

     使用 YAML 文件创建一个新的 Kamelet Binding

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

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

        Copy to Clipboard

     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:

        Copy to Clipboard

     3. 指定源 Kamelet （如 coffee-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:

        Copy to Clipboard

     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

        Copy to Clipboard
     5. 保存 YAML 文件（例如，coffee-to-log.yaml）。

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

        oc apply -f <kamelet-binding>.yaml

        例如：

        oc apply -f coffee-to-log.yaml

        Camel K operator 使用 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 integration 的 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"}

        Copy to Clipboard

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

   Copy to Clipboard

2. 在 source 部分添加一个 integration 部分，并提供以下 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

   Copy to Clipboard

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

   Copy to Clipboard
4. 保存您的更改。

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

   oc apply -f coffee-to-log.yaml

   Camel K operator 会重新生成并运行它根据更新的 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 部分添加 error handler 部分：

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

   Copy to Clipboard

   例如，在 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

   Copy to Clipboard
3. 保存您的文件。

流程

1. 编辑 Kamelet Binding，使其包含 topic-name-matches-filter-action Kamelet 作为源和接收器 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

   Copy to Clipboard

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

   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

   Copy to Clipboard
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 代理列表