4.2. 指定运行时配置选项

流程

1. 开发使用属性的 Camel 集成。以下简单示例包含 {{my.message}} 属性占位符：

   ...
   - from:
      uri: "timer:tick"
      steps:
        - set-body:
            constant: "{{my.message}}"
        - to: "log:info"
   ...

2. 使用以下语法运行集成，在运行时设置属性值：

   kamel run --property <property>=<value> <integration>

   另外，您可以使用 --p 缩写表示法（使用 --property的位置）：

   kamel run --property <property>=<value> <integration>

   例如：

   kamel run --property my.message="Hola Mundo" HelloCamelK.java --dev

   或者

   kamel run --p my.message="Hola Mundo" HelloCamelK.java --dev

   以下是示例结果：

   ...
   [1] 2020-04-13 15:39:59.213 INFO  [main] ApplicationRuntime - Listener org.apache.camel.k.listener.RoutesDumper@6e0dec4a executed in phase Started
   [1] 2020-04-13 15:40:00.237 INFO  [Camel (camel-k) thread #1 - timer://java] info - Exchange[ExchangePattern: InOnly, BodyType: String, Body: Hola Mundo from java]
   ...

流程

1. 创建集成属性文件。以下示例来自名为 my.properties 的文件：

   my.key.1=hello
   my.key.2=world

2. 开发使用属性文件中定义的属性的 Camel 集成。以下示例 Routing.java 集成使用 {{my.key.1}} 和 {{my.key.2=world}} 属性占位符：

   import org.apache.camel.builder.RouteBuilder;
   
   public class Routing extends RouteBuilder {
     @Override
     public void configure() throws Exception {
   
       from("timer:property-file")
          .routeId("property-file")
          .log("property file content is: {{my.key.1}} {{my.key.2}}");
   
     }
   }

3. 使用以下语法运行集成来引用属性文件：

   kamel run --property file:<my-file.properties> <integration>

   另外，您可以使用 --p 缩写表示法（使用 --property的位置）：

   kamel run --p file:<my-file.properties> <integration>

   例如：

   kamel run Routing.java --property:file=my.properties --dev

流程

1. 创建一个 Camel K 集成来引用包含配置值的文本文件。

   例如，以下集成(ConfigFileRoute.java)预期在 classpath 在运行时提供 resources-data.txt 文件：

   import org.apache.camel.builder.RouteBuilder;
   
   public class ConfigFileRoute extends RouteBuilder {
     @Override
     public void configure() throws Exception {
   
       from("timer:config-file")
           .setBody()
               .simple("resource:classpath:resources-data.txt")
           .log("resource file content is: ${body}");
   
     }
   }

2. 运行集成并使用 --config 选项指定文本文件，使其可用于正在运行的集成。例如：

   kamel run --config file:resources-data.txt ConfigFileRoute.java --dev

   另外，您可以通过重复添加 --config 选项来提供多个文件，例如：

   kamel run --config file:resources-data1.txt --config file:resources-data2.txt ConfigFileRoute.java --dev

流程

1. 创建引用 ConfigMap 的 Camel K 集成。

   例如，以下集成（名为 ConfigConfigmapRoute.java）在名为 my-cm 的 ConfigMap 中引用名为 my-configmap-key 的配置值。

   import org.apache.camel.builder.RouteBuilder;
   
   public class ConfigConfigmapRoute extends RouteBuilder {
     @Override
     public void configure() throws Exception {
   
       from("timer:configmap")
           .setBody()
                .simple("resource:classpath:my-configmap-key")
           .log("configmap content is: ${body}");
   
     }
   }

2. 运行集成并使用 --config 选项来定义 ConfigMap 文件，使其可用于正在运行的集成。例如：

   kamel run --config configmap:my-cm ConfigConfigmapRoute.java --dev

   当集成启动时，Camel K operator 会使用 ConfigMap 的内容挂载 OpenShift 卷。

流程

1. 创建引用 ConfigMap 的 Camel K 集成。

   例如，以下集成（名为 ConfigSecretRoute.java）引用位于名为 my-sec 的 Secret 中的 my-secret 属性：

   import org.apache.camel.builder.RouteBuilder;
   
   public class ConfigSecretRoute extends RouteBuilder {
     @Override
     public void configure() throws Exception {
   
       from("timer:secret")
           .setBody()
               .simple("resource:classpath:my-secret")
           .log("secret content is: ${body}");
   
     }
   }

2. 运行集成并使用 --config 选项定义 Secret，使其可用于正在运行的集成。例如：

   kamel run --config secret:my-sec ConfigSecretRoute.java --dev

   当集成启动时，Camel K operator 会使用 Secret 的内容挂载 OpenShift 卷。

流程

1. 创建包含属性的文本文件。

   例如，创建一个名为 my.properties 的文件，其中包含以下属性：

   my.key.1=hello
   my.key.2=world

2. 根据属性文件创建 ConfigMap 或 Secret。

   例如，使用以下命令从 my.properties 文件创建 secret：

   oc create secret generic my-sec --from-file my.properties

3. 在集成中，请参阅 Secret 中定义的属性。

   例如，以下集成（名为 ConfigSecretPropertyRoute.java）引用 my.key.1 和 my.key.2 属性：

   import org.apache.camel.builder.RouteBuilder;
   
   public class ConfigSecretPropertyRoute extends RouteBuilder {
     @Override
     public void configure() throws Exception {
   
       from("timer:secret")
           .routeId("secret")
           .log("{{my.key.1}} {{my.key.2}}");
   
     }
   }

4. 运行集成并使用 --config 选项指定包含 my.key.1 和 my.key.2 属性的 Secret。

   例如：

   kamel run --config secret:my-sec ConfigSecretPropertyRoute.java --dev

流程

1. 创建一个集成，使用来自 ConfigMap 或 Secret 中的一个源的配置值。

   例如，以下集成(ConfigSecretKeyRoute.java)仅使用来自 my-sec-multi secret 中的一个源的属性。

   import org.apache.camel.builder.RouteBuilder;
   
   public class ConfigSecretKeyRoute extends RouteBuilder {
     @Override
     public void configure() throws Exception {
   
       from("timer:secret")
         .setBody()
             .simple("resource:classpath:my-secret-key-2")
         .log("secret content is: ${body}");
     }
   }

2. 使用 --config secret 选项和 /key 表示法运行集成。

   例如：

   kamel run --config secret:my-sec-multi/my-secret-key-2 ConfigSecretKeyRoute.java --dev

3. 检查集成 pod，以验证是否只挂载指定的源（如 my-secret-key-2）。

   例如，运行以下命令来列出 pod 的所有卷：

   oc set volume pod/<pod-name> --all

流程

1. 创建一个 Camel K 集成，它会读取您提供的文件内容。

   例如，以下集成(ResourceFileBinaryRoute.java)解压缩并读取 resources-data.zip 文件：

   import org.apache.camel.builder.RouteBuilder;
   
   public class ResourceFileBinaryRoute extends RouteBuilder {
     @Override
     public void configure() throws Exception {
   
       from("file:/etc/camel/resources/?fileName=resources-data.zip&noop=true&idempotent=false")
           .unmarshal().zipFile()
           .log("resource file unzipped content is: ${body}");
   
     }
   }

2. 运行集成并使用 --resource 选项将文件复制到默认目标目录(/etc/camel/resources/)。例如：

   kamel run --resource file:resources-data.zip ResourceFileBinaryRoute.java -d camel-zipfile --dev

   注： 如果您指定二进制文件，则会在集成中创建并解码文件内容的二进制表示。

   另外，您可以通过重复添加 --resource 选项来提供多个资源，例如：

   kamel run --resource file:resources-data1.txt --resource file:resources-data2.txt ResourceFileBinaryRoute.java -d camel-zipfile --dev

流程

1. 创建 Camel K 集成来引用 OpenShift 集群上存储的 ConfigMap。

   例如，以下集成（名为 ResourceConfigmapRoute.java）引用名为 my-cm 的 ConfigMap，其中包含 my-configmap-key。

   import org.apache.camel.builder.RouteBuilder;
   
   public class ResourceConfigmapRoute extends RouteBuilder {
     @Override
     public void configure() throws Exception {
   
       from("file:/etc/camel/resources/my-cm/?fileName=my-configmap-key&noop=true&idempotent=false")
           .log("resource file content is: ${body}");
   
     }
   }

2. 运行集成并使用 --resource 选项以对默认 /etc/camel/resources/ 目录中的 ConfigMap 文件进行解析，使其可用于正在运行的集成。

   例如：

   kamel run --resource configmap:my-cm ResourceConfigmapRoute.java --dev

   当集成启动时，Camel K operator 会使用 ConfigMap 的内容（如 my-configmap-key）挂载卷。

流程

1. 创建一个 Camel K 集成来引用存储在 OpenShift 集群上的 Secret。

   例如，以下集成（名为 ResourceSecretRoute.java）引用 my-sec Secret：

   import org.apache.camel.builder.RouteBuilder;
   
   public class ResourceSecretRoute extends RouteBuilder {
     @Override
     public void configure() throws Exception {
   
         from("file:/etc/camel/resources/my-sec/?fileName=my-secret-key&noop=true&idempotent=false")
             .log("resource file content is: ${body}");
   
     }
   }

2. 运行集成并使用 --resource 选项，在默认 /etc/camel/resources/ 目录中对 Secret 进行材料化，使其可用于正在运行的集成。

   例如：

   kamel run --resource secret:my-sec ResourceSecretRoute.java --dev

   当集成启动时，Camel K operator 会使用 Secret 的内容（如 my-sec）挂载卷。

流程

1. 创建一个 Camel K 集成来引用包含配置属性的文件、ConfigMap 或 Secret。例如，以下集成（名为 ResourceFileLocationRoute.java）引用 myprops 文件：

   import org.apache.camel.builder.RouteBuilder;
   
   public class ResourceFileLocationRoute extends RouteBuilder {
     @Override
     public void configure() throws Exception {
   
         from("file:/tmp/?fileName=input.txt&noop=true&idempotent=false")
            .log("resource file content is: ${body}");
   
     }
   }

2. 运行集成并使用带 @path 语法的 --resource 选项，并指定挂载资源内容的位置（文件、ConfigMap 或 Secret）：

   例如，以下命令使用 /tmp 目录挂载 input.txt 文件：

   kamel run --resource file:resources-data.txt@/tmp/input.txt ResourceFileLocationRoute.java --dev

3. 检查集成的 pod，以验证文件（如 input.txt）是否已挂载到正确的位置（例如，在 tmp 目录中）。例如，运行以下命令：

   oc exec <pod-name> -- cat /tmp/input.txt

流程

1. 创建使用 ConfigMap 或 Secret 中的一个资源的配置值的集成。例如，以下集成（名为 ResourceConfigmapKeyLocationRoute.java）引用 my-cm-multi ConfigMap：

   import org.apache.camel.builder.RouteBuilder;
   
   public class ResourceConfigmapKeyLocationRoute extends RouteBuilder {
     @Override
     public void configure() throws Exception {
   
       from("file:/tmp/app/data/?fileName=my-configmap-key-2&noop=true&idempotent=false")
          .log("resource file content is: ${body} consumed from
           ${header.CamelFileName}");
   
     }
   }

2. 运行集成并使用带 @path 语法的 --resource 选项，并指定挂载源内容的位置（文件、ConfigMap 或 Secret）：

   例如，以下命令指定只使用 ConfigMap 中包含的源(my-configmap-key-2@)之一，并使用 /tmp/app/data 目录挂载它：

   kamel run --resource configmap:my-cm-multi/my-configmap-key-2@/tmp/app/data ResourceConfigmapKeyLocationRoute.java --dev

3. 检查集成的 pod，以验证只有一个文件（如 my-configmap-key-2）是否已挂载到正确的位置（例如，在 /tmp/app/data 目录中）。例如，运行以下命令：

   oc exec <pod-name> -- cat /tmp/app/data/my-configmap-key-2