Kamelets Distribution

When you install Camel K, you typically got bundled a series of Kamelets which are coming from the Apache Kamelet Catalog. This is a facility that will let you immediately use a wide set of connector-style resources to interact with any event source and sink.

the version we bundle depends directly on the default Camel version used. For instance, in Camel K version 2, the default runtime we use is Camel K Runtime 2.16.0 which depends on Camel version 3.20.1. The Kamelet version we use is the one distributed as v3.20.1.

As development of Kamelet is very fast, make sure to use some version which is compatible with the Camel runtime you’re going to use.

Provide your own catalog

An alternative to the catalog we bundle is to include a repository containing your own catalog. You need to specify it in the IntegrationPlatform .spec.kamelet.repository.

  spec:
    kamelet:
      repositories:
      - uri: <git-platform>:<owner>/<repo>[/path_to_kamelets_folder][@version]

Mind that <git-platform> is the repository of your choice, for instance github and [@version] is the tag to use (by default it will use main branch).

With this approach you can dynamically include any repository where your Kamelets are hosted. They will be lazily initialized as soon as they are required by any of the Integration or Pipes which will make use of them.

Kamelets as a dependency

The Camel K has an opinionated way to use Kamelets which is the one exposed above. Here the Kamelet spec resource is expected to be available in the cluster.

However, you may find situations where you want to bundle a Kamelet in a dependency (ie, some external catalog containing all Kamelets spec). As Kamelets are a Camel thing, then, you can use such dependency and let the runtime use the Kamelets available in the classpath.

If you’re using such an approach, then, you will need to make sure to skip the Kamelet trait (which is in charge to discover them and get required dependencies), and provide all the dependencies which may be required by your Kamelet. Additionally, you may need to specify a Camel property to tell the runtime where to expect to find the Kamelets, camel.component.kamelet.location (default classpath:/kamelets).