Get started with Kestra in 4 minutes.
Java Message Service support for Kestra
This repository contains a set of plugins to use JMS with your Kestra flows. The goal if this plugin is to remain as generic as possible and stick with the JMS standard APIs. The plugin should work with any JMS 1.x compliant implementation.
Even older client versions using javax.jms instead of jakarta.jms are supported. The compatibility is ensured using the CONAPI JMS-adapter.
The generic approach requires you to provide the JMS client libraries with your deployment. The most convenient (default) way is to put the JAR files in a sub folder of your Kestra plugins folder called 'jms-libs'. Alternatively you can specify the jar file location as part of the trigger/task configuration.
Configuration examples are provided in the test/resources flows location.
For simple testing of the plugin, we highly recommend [Message Manager] (https://conapi.at/message-manager/)
NOTE: As a Kestra user you get a free 12 months Professional license of Message Manager. Use the contact form on the conapi website.
There are also some blogs with instructions and a video demo available:
- https://conapi.at/gravitee-kestra-integration-apis-workflows/
- https://conapi.at/kestra-jms-integration-trigger-send-receive/
This repository contains three different plugins:
Can be used to start a new flow execution whenever a JMS message is received.
Can be used at task level inside a flow to consume/receive JMS messages.
Can be used at task level inside a flow to send a JMS messages to a queue or a topic.
- Java 21
- Docker
Ensure you have ActiveMQ Artemis running. You can use the provided docker-compose-ci.yml:
docker-compose -f docker-compose-ci.yml up -d
./gradlew check --parallelVSCode:
Follow the README.md within the .devcontainer folder for a quick and easy way to get up and running with developing plugins if you are using VSCode.
Other IDEs:
./gradlew shadowJar && docker-compose up
Note
You need to relaunch this whole command everytime you make a change to your plugin
go to http://localhost:8080, your plugin will be available to use
- Full documentation can be found under: kestra.io/docs
- Documentation for developing a plugin is included in the Plugin Developer Guide
Apache 2.0 © Kestra Technologies
We release new versions every month. Give the main repository a star to stay up to date with the latest releases and get notified about future updates.
