This quickstart demonstrates how to connect a Spring-Boot application to EnMasse (MaaS) and use JMS messaging between two Camel routes using Kubernetes or OpenShift.
In this example we will use two containers, one container to run as an EnMasse instance, and another as a client to the broker, where the Camel routes are running.
This quickstart requires EnMasse to have been deployed and running first. To install EnMasse into OpenShift or Kubernetes follow documentation.
The application utilizes the Spring @ImportResource
annotation to load a Camel Context definition via a src/main/resources/spring/camel-context.xml file on the classpath.
Important
|
This quickstart can run in 2 modes: standalone on your machine and on Kubernetes / OpenShift Cluster |
You can run this quickstart in the following modes:
-
Kubernetese / Single-node OpenShift cluster
-
Standalone on your machine
The most effective way to run this quickstart is to deploy and run the project on OpenShift.
For more details about running this quickstart on a single-node OpenShift cluster, CI/CD deployments, as well as the rest of the runtime, see the Spring Boot Runtime Guide.
A single-node Kubernetes/OpenShift cluster provides you with access to a cloud environment that is similar to a production environment.
If you have a single-node Kubernetes/OpenShift cluster, such as Minishift or the Red Hat Container Development Kit, installed and running, you can deploy your quickstart there.
To deploy this quickstart to a running single-node OpenShift cluster:
-
Download the project and extract the archive on your local filesystem.
-
Log in to your OpenShift cluster:
$ oc login -u developer -p developer
-
Create a new OpenShift project for the quickstart:
$ oc new-project MY_PROJECT_NAME
-
Change the directory to the folder that contains the extracted quickstart application (for example,
my_openshift/spring-boot-camel-amq
) :$ cd my_openshift/spring-boot-camel-amq
-
Before running the quickstart, you need to configure EnMasse (create user and queue - both as an admin). Run the following commands to apply configuration files:
$ oc login -u system:admin $ oc apply -f src/main/resources/k8s
-
Build and deploy the project to the OpenShift cluster:
$ mvn clean -DskipTests fabric8:deploy -Popenshift
-
In your browser, navigate to the
MY_PROJECT_NAME
project in the OpenShift console. Wait until you can see that the pod for thespring-boot-camel-amq
has started up. -
On the project’s
Overview
page, navigate to the details page deployment of thespring-boot-camel-amq
application:https://OPENSHIFT_IP_ADDR:8443/console/project/MY_PROJECT_NAME/browse/rc/spring-boot-camel-amq-NUMBER_OF_DEPLOYMENT?tab=details
. -
Switch to tab
Logs
and then see the messages sent by Camel.
To run this quickstart as a standalone project on your local machine:
-
You need to have a running instance of EnMasse with messaging user
admin:test
and queueincomingOrders
.You can use EnMasse instance from previous steps. You need to configure the
src/main/resources/application.properties
file in order to use the correct remote instance of EnMasse.Get remote url of EnMasse instance by running the following command:
$ oc get addressspace spring-boot-camel-amq -o jsonpath={.status.endpointStatuses[?(@.name==\'messaging\')].externalHost}
Fill this value into
src/main/resources/application.properties
instead ofFILL_ME
. -
Download the project and extract the archive on your local filesystem.
-
Build the project:
$ cd PROJECT_DIR $ mvn clean package
-
Run the service:
$ mvn spring-boot:run
-
See the messages sent by Camel.