Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 1. Managing Camel K integrations

You can manage Red Hat Integration - Camel K integrations using the Camel K command line or using development tools. This chapter explains how to manage Camel K integrations on the command line and provides links to additional resources that explain how to use the VS Code development tools.

1.1. Managing Camel K integrations
Copy link

Camel K provides different options for managing Camel K integrations on your OpenShift cluster on the command line. This section shows simple examples of using the following commands:

  • kamel get
  • kamel describe
  • kamel log
  • kamel delete

Prerequisites

Procedure

  1. Ensure that the Camel K Operator is running on your OpenShift cluster, for example: 

    oc get pod
    Copy to Clipboard Toggle word wrap 
    NAME                               READY   STATUS    RESTARTS   AGE
camel-k-operator-86b8d94b4-pk7d6   1/1     Running   0          6m28s
    Copy to Clipboard Toggle word wrap

  2. Enter the kamel run command to run your integration in the cloud on OpenShift. For example: 

    kamel run hello.camelk.yaml
    Copy to Clipboard Toggle word wrap 
    integration "hello" created
    Copy to Clipboard Toggle word wrap

  3. Enter the kamel get command to check the status of the integration: 

    kamel get
    Copy to Clipboard Toggle word wrap 
    NAME   PHASE        KIT
hello  Building Kit kit-bqatqib5t4kse5vukt40
    Copy to Clipboard Toggle word wrap

  4. Enter the kamel describe command to print detailed information about the integration: 

    kamel describe integration hello
    Copy to Clipboard Toggle word wrap 
    Name:                hello
Namespace:           myproject
Creation Timestamp:  Fri, 13 Aug 2021 16:23:21 +0200
Phase:               Building Kit
Runtime Version:     1.7.1.fuse-800025-redhat-00001
Kit:                 myproject/kit-c4ci6mbe9hl5ph5c9sjg
Image:
Version:             1.6.6
Dependencies:
  camel:core
  camel:log
  camel:timer
  mvn:org.apache.camel.k:camel-k-runtime
  mvn:org.apache.camel.quarkus:camel-quarkus-yaml-dsl
Sources:
  Name                        Language  Compression  Ref  Ref Key
  camel-k-embedded-flow.yaml  yaml      false
Conditions:
  Type                          Status  Reason                        Message
  IntegrationPlatformAvailable  True    IntegrationPlatformAvailable  myproject/camel-k
  IntegrationKitAvailable       True    IntegrationKitAvailable       kit-c4ci6mbe9hl5ph5c9sjg
  CronJobAvailable              False   CronJobNotAvailableReason     different controller strategy used (deployment)
  DeploymentAvailable           True    DeploymentAvailable           deployment name is hello
  KnativeServiceAvailable       False   KnativeServiceNotAvailable    different controller strategy used (deployment)
  Ready                         True    ReplicaSetReady
    Copy to Clipboard Toggle word wrap

  5. Enter the kamel log command to print the log to stdout: 

    kamel log hello
    Copy to Clipboard Toggle word wrap 
    ...
[1] 2021-08-13 14:37:15,860 INFO [info] (Camel (camel-1) thread #0 - timer://yaml) Exchange[ExchangePattern: InOnly, BodyType: String, Body: Hello Camel K from yaml]
...
    Copy to Clipboard Toggle word wrap
  6. Press Ctrl-C to terminate logging in the terminal.

  7. Enter the kamel delete to delete the integration deployed on OpenShift: 

    kamel delete hello
    Copy to Clipboard Toggle word wrap 
    Integration hello deleted
    Copy to Clipboard Toggle word wrap

Additional resources

1.2. Managing Camel K integration logging levels
Copy link

Camel K uses Quarkus Logging mechanism as the logging framework for integrations. You can configure the logging levels of various loggers on the command line at runtime by specifying the quarkus.log.category prefix as an integration property. For example:

Example

--property 'quarkus.log.category."org".level'=DEBUG
Copy to Clipboard Toggle word wrap

Note

It is important to escape the property with single quotes.

Prerequisites

Procedure

  1. Enter the kamel run command and specify the logging level using the --property option. For example: 

    kamel run --dev --property 'quarkus.log.category."org.apache.camel.support".level'=DEBUG Basic.java

...
integration "basic" created
    Progress: integration "basic" in phase Initialization
    Progress: integration "basic" in phase Building Kit
    Progress: integration "basic" in phase Deploying
    Condition "IntegrationPlatformAvailable" is "True" for Integration basic: myproject/camel-k
    Integration basic in phase "Initialization"
    Integration basic in phase "Building Kit"
    Integration basic in phase "Deploying"
    Condition "IntegrationKitAvailable" is "True" for Integration basic: kit-c4dn5l62v9g3aopkocag
    Condition "DeploymentAvailable" is "True" for Integration basic: deployment name is basic
    Condition "CronJobAvailable" is "False" for Integration basic: different controller strategy used (deployment)
    Progress: integration "basic" in phase Running
    Condition "KnativeServiceAvailable" is "False" for Integration basic: different controller strategy used (deployment)
    Integration basic in phase "Running"
    Condition "Ready" is "False" for Integration basic
    Condition "Ready" is "True" for Integration basic
    [1] Monitoring pod basic-575b97f64b-7l5rl
    [1] 2021-08-17 08:35:22,906 DEBUG [org.apa.cam.sup.LRUCacheFactory] (main) Creating DefaultLRUCacheFactory
    [1] 2021-08-17 08:35:23,132 INFO  [org.apa.cam.k.Runtime] (main) Apache Camel K Runtime 1.7.1.fuse-800025-redhat-00001
    [1] 2021-08-17 08:35:23,134 INFO  [org.apa.cam.qua.cor.CamelBootstrapRecorder] (main) bootstrap runtime: org.apache.camel.quarkus.main.CamelMainRuntime
    [1] 2021-08-17 08:35:23,224 INFO  [org.apa.cam.k.lis.SourcesConfigurer] (main) Loading routes from: SourceDefinition{name='Basic', language='java', location='file:/etc/camel/sources/Basic.java', }
    [1] 2021-08-17 08:35:23,232 DEBUG [org.apa.cam.sup.ResolverHelper] (main) Found RoutesBuilderLoader: org.apache.camel.dsl.java.joor.JavaRoutesBuilderLoader via: META-INF/services/org/apache/camel/java
    [1] 2021-08-17 08:35:23,232 DEBUG [org.apa.cam.sup.ResolverHelper] (main) Detected and using RoutesBuilderLoader: org.apache.camel.dsl.java.joor.JavaRoutesBuilderLoader@68dc098b
    [1] 2021-08-17 08:35:23,236 DEBUG [org.apa.cam.sup.ResolverHelper] (main) Found ResourceResolver: org.apache.camel.impl.engine.DefaultResourceResolvers$FileResolver via: META-INF/services/org/apache/camel/file
    [1] 2021-08-17 08:35:23,237 DEBUG [org.apa.cam.sup.ResolverHelper] (main) Detected and using ResourceResolver: org.apache.camel.impl.engine.DefaultResourceResolvers$FileResolver@5b67bb7e
    [1] 2021-08-17 08:35:24,320 DEBUG [org.apa.cam.sup.ResolverHelper] (main) Lookup Language with name simple in registry. Found: org.apache.camel.language.simple.SimpleLanguage@74d7184a
    [1] 2021-08-17 08:35:24,328 DEBUG [org.apa.cam.sup.EventHelper] (main) Ignoring notifying event Initializing CamelContext: camel-1. The EventNotifier has not been started yet: org.apache.camel.quarkus.core.CamelManagementEventBridge@3301500b
    [1] 2021-08-17 08:35:24,336 DEBUG [org.apa.cam.sup.ResolverHelper] (main) Lookup Component with name timer in registry. Found: org.apache.camel.component.timer.TimerComponent@3ef41c66
    [1] 2021-08-17 08:35:24,342 DEBUG [org.apa.cam.sup.DefaultComponent] (main) Creating endpoint uri=[timer://java?period=1000], path=[java]
    [1] 2021-08-17 08:35:24,350 DEBUG [org.apa.cam.sup.ResolverHelper] (main) Found ProcessorFactory: org.apache.camel.processor.DefaultProcessorFactory via: META-INF/services/org/apache/camel/processor-factory
    [1] 2021-08-17 08:35:24,351 DEBUG [org.apa.cam.sup.ResolverHelper] (main) Detected and using ProcessorFactory: org.apache.camel.processor.DefaultProcessorFactory@704b2127
    [1] 2021-08-17 08:35:24,369 DEBUG [org.apa.cam.sup.ResolverHelper] (main) Found InternalProcessorFactory: org.apache.camel.processor.DefaultInternalProcessorFactory via: META-INF/services/org/apache/camel/internal-processor-factory
    [1] 2021-08-17 08:35:24,369 DEBUG [org.apa.cam.sup.ResolverHelper] (main) Detected and using InternalProcessorFactory: org.apache.camel.processor.DefaultInternalProcessorFactory@4f8caaf3
    [1] 2021-08-17 08:35:24,442 DEBUG [org.apa.cam.sup.ResolverHelper] (main) Lookup Component with name log in registry. Found: org.apache.camel.component.log.LogComponent@46b695ec
    [1] 2021-08-17 08:35:24,444 DEBUG [org.apa.cam.sup.DefaultComponent] (main) Creating endpoint uri=[log://info], path=[info]
    [1] 2021-08-17 08:35:24,461 DEBUG [org.apa.cam.sup.EventHelper] (main) Ignoring notifying event Initialized CamelContext: camel-1. The EventNotifier has not been started yet: org.apache.camel.quarkus.core.CamelManagementEventBridge@3301500b
    [1] 2021-08-17 08:35:24,467 DEBUG [org.apa.cam.sup.DefaultProducer] (main) Starting producer: Producer[log://info]
    [1] 2021-08-17 08:35:24,469 DEBUG [org.apa.cam.sup.DefaultConsumer] (main) Build consumer: Consumer[timer://java?period=1000]
    [1] 2021-08-17 08:35:24,475 DEBUG [org.apa.cam.sup.DefaultConsumer] (main) Starting consumer: Consumer[timer://java?period=1000]
    [1] 2021-08-17 08:35:24,481 INFO  [org.apa.cam.imp.eng.AbstractCamelContext] (main) Routes startup summary (total:1 started:1)
    [1] 2021-08-17 08:35:24,481 INFO  [org.apa.cam.imp.eng.AbstractCamelContext] (main)     Started java (timer://java)
    [1] 2021-08-17 08:35:24,482 INFO  [org.apa.cam.imp.eng.AbstractCamelContext] (main) Apache Camel 3.10.0.fuse-800010-redhat-00001 (camel-1) started in 170ms (build:0ms init:150ms start:20ms)
    [1] 2021-08-17 08:35:24,487 INFO  [io.quarkus] (main) camel-k-integration 1.6.6 on JVM (powered by Quarkus 1.11.7.Final-redhat-00009) started in 2.192s.
    [1] 2021-08-17 08:35:24,488 INFO  [io.quarkus] (main) Profile prod activated.
    [1] 2021-08-17 08:35:24,488 INFO  [io.quarkus] (main) Installed features: [camel-bean, camel-core, camel-java-joor-dsl, camel-k-core, camel-k-runtime, camel-log, camel-support-common, camel-timer, cdi]
    [1] 2021-08-17 08:35:25,493 INFO  [info] (Camel (camel-1) thread #0 - timer://java) Exchange[ExchangePattern: InOnly, BodyType: String, Body: Hello Camel K from java]
    [1] 2021-08-17 08:35:26,479 INFO  [info] (Camel (camel-1) thread #0 - timer://java) Exchange[ExchangePattern: InOnly, BodyType: String, Body: Hello Camel K from java]
...
    Copy to Clipboard Toggle word wrap
  2. Press Ctrl-C to terminate logging in the terminal.

Additional resources

1.3. Scaling Camel K integrations
Copy link

You can scale your integrations using the oc scale command.

Procedure

  • To scale the Camel K integrations, run the following command. 

    oc scale it <integration_name> --replicas <number_of_replicas>
    Copy to Clipboard Toggle word wrap

  • You can also edit the Integration resource directly to scale the integration. 

    oc patch it <integration_name> --type merge -p '{"spec":{"replicas":<number_of_replicas>}}'
    Copy to Clipboard Toggle word wrap

    To view the number of replicas for the integration use following command. 

    oc get it <integration_name> -o jsonpath='{.status.replicas}'
    Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat