Getting started
All you need to get started with Joule.
Last updated
Was this helpful?
All you need to get started with Joule.
Last updated
Was this helpful?
This tutorial aims to teach how to run a real-time banking example with your first Joule.
We have tailored this tutorial for anyone who wants to learn how to use Joule for the first time and who wishes to learn how to deploy a first use case given that your environment is setup already.
Build your environment with .
By the end of this tutorial, we will have learned:
How to start and stop Joule.
Deploy a first real-time use case.
Access the Redpanda interface to see the deployed use case in action.
Docker or any other alternative to run containers.
Only install the below if you do not want to run Docker images of vendor software:
The following steps will guide us on setting up our environment to deploy our images and containers with Joule.
We will clone the repository with this command.
Once cloned, we will checkout to dev.
We will navigate to the quickstart
directory.
We will make sure that Docker or our alternative is running.
We are now ready to start building Joule. To start Joule, we need to run the following command which will start building our images and containers.
In the case of this use case, we will run the following command from the ~/quickstart
location:
The command will start up the following containers ready for use case deployment:
Joule Daemon
Joule Database
Redpanda
The banking demo directories provides a set of examples in the form of a postman collection and environment. These can be found under the examples
directory.
We will now get started running the banking Getting Started
demo example using Postman.
First we will import the use case demos and environment files from the banking-demo examples
directory.
We will set the Postman environment to Joule
.
From the Getting started \ Deploy
folder click Run folder
from the menu.
Finally execute the run order by clicking the Run Joule - Banking demo
button.
This will deploy the source, stream, sink and the use case binding definition to the platform.
The banking demo is provided with a quote simulator which is seeded using
This command will generate a continuous set of quote and publish them to the quotes
topic. We will see how to access the topic on the next step.
Press return
to continue.
Once the processing pipeline completes its tasks, the resulting events are published on to the analytics_view
topic ready for further consumption (i.e. distribution, dashboard, dynamic portfolio risk measures etc).
Once we are ready to shut down Joule, we will first stop the quotes publisher by executing the command below.
We can now undeploy the use case and its linked components by executing the Run Joule - Banking demo
under the Undeploy
use case folder.
In case we want to execute complete shut down of Joule, we can instead follow the steps below.
Once quotes publisher has been stopped the Joule environment can now be shutdown. We have 2 options to shut Joule down.
We covered essential steps to run our first Joule including cloning the repository and running a first streaming banking use case via Postman.
In summary we have learned:
How to publish continuous data streams with the quote simulator.
How to see our use case in execution in the Redpanda interface.
How to review and process analytics outputs through our default use case.
How to stop, shut down the Joule environment and clean up the system.
Now that we have learned the basics about Joule, it is time to learn how to create our own use case.
Understanding of how to navigate with the command line through directories. Not sure how to navigate with command line? .
Java is installed. Don’t have Java? .
Postman is installed. Don’t have Postman? .
Git is installed. Don’t have Git? .
Redpanda is installed. Don’t have Redpanda? .
To learn how to navigate the interface, .
Access the Redpanda interface