4.2. 런타임 구성 옵션 지정

프로세스

1. 속성을 사용하는 Camel 통합을 개발합니다. 다음 간단한 예제에는 {{my.message}} 속성 자리 표시자가 포함되어 있습니다.

   Copy to Clipboard Toggle word wrap

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

2. 다음 구문을 사용하여 통합을 실행하여 런타임 시 속성 값을 설정합니다.

   Copy to Clipboard Toggle word wrap

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

   또는 --p 단축 표기법을 사용할 수 있습니다( --property대신).

   Copy to Clipboard Toggle word wrap

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

   예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

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

   또는

   Copy to Clipboard Toggle word wrap

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

   다음은 예제 결과입니다.

   Copy to Clipboard Toggle word wrap

   ...
   [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 인 파일에서 가져온 것입니다.

   Copy to Clipboard Toggle word wrap

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

2. 속성 파일에 정의된 속성을 사용하는 Camel 통합을 개발합니다. 다음 예제 Routing.java 통합에서는 {{my.key.1}} 및 {{my.key.2=world}} 속성 자리 표시자를 사용합니다.

   Copy to Clipboard Toggle word wrap

   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. 다음 구문을 사용하여 통합을 실행하여 속성 파일을 참조합니다.

   Copy to Clipboard Toggle word wrap

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

   또는 --p 단축 표기법을 사용할 수 있습니다( --property대신).

   Copy to Clipboard Toggle word wrap

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

   예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

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

프로세스

1. 구성 값이 포함된 텍스트 파일을 참조하는 Camel K 통합을 생성합니다.

   예를 들어 다음 통합(ConfigFileRoute.java)에서는 런타임 시 classpath에서 resources-data.txt 파일을 사용할 수 있을 것으로 예상합니다.

   Copy to Clipboard Toggle word wrap

   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 옵션을 사용하여 실행 중인 통합에서 사용할 수 있도록 텍스트 파일을 지정합니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

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

   선택적으로 --config 옵션을 반복적으로 추가하여 두 개 이상의 파일을 제공할 수 있습니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   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 라는 구성 값을 참조합니다.

   Copy to Clipboard Toggle word wrap

   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 파일을 구체화합니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

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

   통합이 시작되면 Camel K Operator는 ConfigMap의 콘텐츠를 사용하여 OpenShift 볼륨을 마운트합니다.

프로세스

1. ConfigMap을 참조하는 Camel K 통합을 생성합니다.

   예를 들어 다음 통합( ConfigSecretRoute.java)은 my-sec 이라는 시크릿에 있는 my-secret 속성을 참조합니다.

   Copy to Clipboard Toggle word wrap

   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 옵션을 사용하여 실행 중인 통합에서 사용할 수 있도록 보안을 구체화합니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

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

   통합이 시작되면 Camel K Operator는 Secret의 콘텐츠를 사용하여 OpenShift 볼륨을 마운트합니다.

프로세스

1. 속성이 포함된 텍스트 파일을 만듭니다.

   예를 들어 다음 속성을 포함하는 my.properties 라는 파일을 만듭니다.

   Copy to Clipboard Toggle word wrap

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

2. 속성 파일을 기반으로 ConfigMap 또는 보안을 생성합니다.

   예를 들어 다음 명령을 사용하여 my.properties 파일에서 보안을 생성합니다.

   Copy to Clipboard Toggle word wrap

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

3. 통합에서 보안에 정의된 속성을 참조하십시오.

   예를 들어 다음 통합( ConfigSecretPropertyRoute.java)은 my.key.1 및 my.key.2 속성을 참조합니다.

   Copy to Clipboard Toggle word wrap

   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을 지정합니다.

   예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

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

프로세스

1. ConfigMap 또는 Secret의 소스 중 하나에서 구성 값을 사용하는 통합을 생성합니다.

   예를 들어 다음 통합(ConfigSecretKeyRoute.java)은 my-sec-multi 시크릿의 소스 중 하나만의 속성을 사용합니다.

   Copy to Clipboard Toggle word wrap

   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 표기법을 사용하여 통합을 실행합니다.

   예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

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

3. 통합 Pod를 확인하여 지정된 소스(예: my-secret-key-2)만 마운트되었는지 확인합니다.

   예를 들어 다음 명령을 실행하여 Pod의 모든 볼륨을 나열합니다.

   Copy to Clipboard Toggle word wrap

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

프로세스

1. 사용자가 제공하는 파일의 내용을 읽는 Camel K 통합을 생성합니다.

   예를 들어 다음 통합(ResourceFileBinaryRoute.java)의 압축을 풀고 resources-data.zip 파일을 읽습니다.

   Copy to Clipboard Toggle word wrap

   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/)에 복사합니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

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

   참고: 바이너리 파일을 지정하면 통합에서 파일 내용의 바이너리 표현이 생성되고 디코딩됩니다.

   선택적으로 --resource 옵션을 반복적으로 추가하여 두 개 이상의 리소스를 제공할 수 있습니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

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

프로세스

1. OpenShift 클러스터에 저장된 ConfigMap을 참조하는 Camel K 통합을 생성합니다.

   예를 들어 다음 통합( ResourceConfigmapRoute.java)은 my-configmap-key 가 포함된 my-cm 라는 ConfigMap을 참조합니다.

   Copy to Clipboard Toggle word wrap

   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 파일을 구체화합니다.

   예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

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

   통합이 시작되면 Camel K Operator는 ConfigMap의 콘텐츠(예: my-configmap-key)를 사용하여 볼륨을 마운트합니다.

프로세스

1. OpenShift 클러스터에 저장된 보안을 참조하는 Camel K 통합을 생성합니다.

   예를 들어 다음 통합( ResourceSecretRoute.java)은 my-sec 보안을 참조합니다.

   Copy to Clipboard Toggle word wrap

   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/ 디렉터리에 보안을 구체화합니다.

   예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

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

   통합이 시작되면 Camel K Operator는 Secret의 콘텐츠(예: my-sec)를 사용하여 볼륨을 마운트합니다.

프로세스

1. 구성 속성이 포함된 파일 ConfigMap 또는 Secret을 참조하는 Camel K 통합을 생성합니다. 예를 들어 다음 통합( ResourceFileLocationRoute.java)은 myprops 파일을 참조합니다.

   Copy to Clipboard Toggle word wrap

   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 파일을 마운트하도록 지정합니다.

   Copy to Clipboard Toggle word wrap

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

3. 통합의 pod를 확인하여 파일(예: input.txt)이 올바른 위치(예: tmp 디렉터리 )에 마운트되었는지 확인합니다. 예를 들어 다음 명령을 실행합니다.

   Copy to Clipboard Toggle word wrap

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

프로세스

1. ConfigMap 또는 Secret의 리소스 중 하나에서 구성 값을 사용하는 통합을 생성합니다. 예를 들어 다음 통합( ResourceConfigmapKeyLocationRoute.java)은 my-cm-multi ConfigMap을 참조합니다.

   Copy to Clipboard Toggle word wrap

   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 디렉토리를 사용하여 마운트하도록 지정합니다.

   Copy to Clipboard Toggle word wrap

   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 디렉터리)에 마운트되었는지 확인합니다. 예를 들어 다음 명령을 실행합니다.

   Copy to Clipboard Toggle word wrap

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