CAMEL-22986: Use official kamelets from camel-kamelets catalog JAR

kamelet-chucknorris/README.adoc

@@ -2,13 +2,23 @@
 
 === Introduction
 
-This example shows how you can build a simple Kamelet and use with your Camel applications.
+This example shows how to use an official Kamelet from the
+https://camel.apache.org/camel-kamelets/next/[Kamelets Catalog]
+in a traditional Maven-based Camel application.
 
-The Kamelet is created as a YAML file in the `src/main/resources/kamelets' directory.
-We have developed a Chuck Norris Kamelet that periodically gets a joke from the Chuck Norris internet database.
+The example uses the
+https://camel.apache.org/camel-kamelets/next/chuck-norris-source.html[Chuck Norris Source]
+Kamelet which periodically gets a joke from the Chuck Norris internet database.
 
-A Camel routes is _coded_ in the `my-route.xml` file using the XML DSL that uses the Kamelet,
-and log the result from the Kamelet to the console.
+The official Kamelets are included as a Maven dependency by adding the `camel-kamelets`
+JAR to the `pom.xml`. Kamelets are then auto-discovered from the classpath at runtime.
+
+NOTE: The `camel-kamelets` JAR only contains the Kamelet YAML definitions. You must also
+add the Camel component dependencies that the Kamelet uses internally
+(e.g. `camel-timer`, `camel-http`, `camel-jsonpath` for the Chuck Norris Kamelet).
+
+The Camel route is defined in `my-route.camel.yaml` using the YAML DSL and logs
+the joke to the console.
 
 === Build
 

kamelet-chucknorris/pom.xml

@@ -31,7 +31,7 @@
     <artifactId>camel-example-kamelet-chucknorris</artifactId>
     <packaging>jar</packaging>
     <name>Camel :: Example :: Kamelet :: Chuck Norris</name>
-    <description>How easy it is to create your own Kamelets</description>
+    <description>How easy it is to use a Kamelet in your Camel application</description>
 
     <properties>
         <category>Kamelet</category>
@@ -47,20 +47,39 @@
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
+            <dependency>
+                <groupId>org.apache.camel.kamelets</groupId>
+                <artifactId>camel-kamelets</artifactId>
+                <version>${camel-kamelets-catalog-version}</version>
+            </dependency>
         </dependencies>
     </dependencyManagement>
 
     <dependencies>
 
-        <!-- main to easily run with Kamelets -->
+        <!-- main dependencies -->
         <dependency>
             <groupId>org.apache.camel</groupId>
-            <artifactId>camel-kamelet-main</artifactId>
+            <artifactId>camel-core</artifactId>
         </dependency>
-        <!-- to use XML DSL -->
         <dependency>
             <groupId>org.apache.camel</groupId>
-            <artifactId>camel-xml-io-dsl</artifactId>
+            <artifactId>camel-main</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>org.apache.camel</groupId>
+            <artifactId>camel-kamelet</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.camel.kamelets</groupId>
+            <artifactId>camel-kamelets</artifactId>
+        </dependency>
+
+        <!-- to use YAML DSL for route definitions -->
+        <dependency>
+            <groupId>org.apache.camel</groupId>
+            <artifactId>camel-yaml-dsl</artifactId>
         </dependency>
 
         <!-- these dependencies are used by the kamelet -->
@@ -90,6 +109,7 @@
             <version>${log4j2-version}</version>
             <scope>runtime</scope>
         </dependency>
+
         <!-- for testing -->
         <dependency>
             <groupId>org.apache.camel</groupId>
@@ -105,6 +125,10 @@
                 <groupId>org.apache.camel</groupId>
                 <artifactId>camel-maven-plugin</artifactId>
                 <version>${camel.version}</version>
+                <configuration>
+                    <logClasspath>false</logClasspath>
+                    <mainClass>org.apache.camel.example.MyApplication</mainClass>
+                </configuration>
             </plugin>
         </plugins>
     </build>

kamelet-chucknorris/src/main/resources/application.properties

@@ -19,6 +19,10 @@
 # https://camel.apache.org/components/next/others/main.html
 camel.main.name = MyKameletCamel
 
-# routes to load
-camel.main.routes-include-pattern = camel/*.xml
+# routes to load, not needed here as routes from classpath:camel/* are
+# automatically loaded
+# camel.main.routes-include-pattern = camel/*.yaml
+
+# configure the period of the Chuck Norris Source Kamelet
+camel.kamelet.chuck-norris-source.period=60000
 

kamelet-chucknorris/src/main/resources/camel/my-route.camel.yaml

@@ -0,0 +1,5 @@
+- route:
+    from:
+      uri: kamelet:chuck-norris-source
+      steps:
+        - log: "${body}"

kamelet-chucknorris/src/main/resources/log4j2.properties

@@ -18,6 +18,6 @@
 appender.out.type = Console
 appender.out.name = out
 appender.out.layout.type = PatternLayout
-appender.out.layout.pattern = [%30.30t] %-30.30c{1} %-5p %m%n
+appender.out.layout.pattern = %d [%20.20t] %-20.20c{1} %-5p %m%n
 rootLogger.level = INFO
 rootLogger.appenderRef.out.ref = out

kamelet-chucknorris/src/test/java/org/apache/camel/example/KameletChuckNorrisTest.java

@@ -40,6 +40,6 @@ void should_use_a_simple_kamelet() {
 
     @Override
     protected void configure(MainConfigurationProperties configuration) {
-        configuration.withRoutesIncludePattern("camel/*");
+        configuration.withRoutesIncludePattern("camel/*.yaml");
     }
 }