How to containerize your Camel route on Karaf within OpenShift

The Red Hat JBoss Fuse solution offers a new approach of ESB, both lightweight and modular. It is perfectly suited to allow you to implement light integrations.

JBoss Fuse is fully supported, based on the power of Apache Karaf — Karaf allows for the easy deployment of your ActiveMQ Broker, your CXF web services, or your own Apache Camel routes.

Most of us are more familiar with the OSGI Environment, and what it offers: things like control of classloader behavior, module isolation, and APIs within a single app/JVM process.

For this post, we are gonna to setup a simple camel-route using a FIS (Fuse Integration Service) based on a Karaf image (jboss-fuse-6/fis-karaf-openshift), with which we will containerize your camel route on Karaf within OpenShift!

To get started, your Maven Archetype catalog includes some examples, but let’s see my example available here: karaf-camel-rest-ose.

This example shows a simple Apache Camel microservice that exposes a REST service and logs a message in karaf.

All the necessary dependencies of this camel route are listed as features to our Karaf distribution on startup in the karaf-maven plugin:

We can override files using resources from src/main/resources/assembly/. The included sample log file etc/org.ops4j.pax.logging.cfg allows you to customize your logging — in my case the log level is set to DEBUG.

This Camel route is implemented using solely the XML DSL (there is no Java code). The source code is provided in the following XML file src/main/resources/OSGI-INF/blueprint/camel-rest.xml:

The endpoint of our Rest service is exposed on the port 9191, This port should be also declared & exposed in the docker by setting the http port in docker-maven-plugin:

and the service is configured in the pom.xml for the fabric8 plugin:

In order to deploy this example to OpenShift, you can use one of the following application development workflows:

  • Fabric8 Maven Workflow
  • OpenShift Source-to-Image (S2I) Workflow

When doing local development, you can simply use fabric8 maven workflow by choosing -Pf8-local-deploy as a goal which creates container and JSON templates. Those templates may then be applied to OpenShift with the following command:

mvn -Pf8-local-deploy

When the example runs in OpenShift, you can use the OpenShift client tool to inspect the status:

$ oc get pods
NAME                         READY     STATUS    RESTARTS   AGE
karaf-camel-rest-ose-k8fqw   1/1       Running   0          1h

Next, find the name of the pod that runs this example, and output the logs from the running pods with the following command:

$ oc logs karaf-camel-rest-ose-k8fqw

You can test the application by running the restful endpoint, like so:

http://karaf-camel-rest-ose.rhel-cdk.10.1.2.2.xip.io/FIS/Awesome

To access the hawtio console, which is embedded by default in OpenShift Console, click the “Open java console” button (you will need to have permission to see/use this feature):

karaf_hawtio_ose

In the application console, we see the route is active:

karaf_ose

Thanks for reading and hope that you enjoy this post!!


Join Red Hat Developers, a developer program for you to learn, share, and code faster – and get access to Red Hat software for your development.  The developer program and software are both free!

 


Download and learn more about Red Hat JBoss Fuse, an innovative modular, cloud-ready architecture, powerful management and automation, and world class developer productivity. It is Java™ EE 7 certified and features powerful, enterprise-grade features such as high availability clustering, distributed caching, messaging, transactions, and a full web services stack.


For more information about Red Hat OpenShift and other related topics, visit: OpenShift, OpenShift Online.

Leave a Reply