This is a Apache Camel Workshop "from zero to hero". It starts from basic features, like how to expose a REST endpoint, to building a complex system composed of multiple microservices and coordinating actions using the Saga pattern to obtain consistency.
All artifacts produced in the workshop are present under the /app directory, but we suggest to follow the step-by-step guide.
The slides for this workshop are located here.
You can check the Youtube video to see all services in action.
The final result of the workshop is a "Plush Shop Demo".
A demo user can make purchases on the Plush Shop, if he has enough credit...
The system is composed of a Angular 6 UI interface backed by 4 microservices.
The role of each service is:
- UI (Angular 6 on Node.js or any static HTTP server): a graphical user interface that is provided for the workshop and can be used to test the full application;
- Recommendation (Camel on Spring-Boot): a simple recommendation service that provide ratings for the best items;
- Credit (Camel on Spring-Boot): manages how much money is owned by the user(s);
- Inventory (Camel on Spring-Boot): manages items present in stock and movement out of it;
- Gateway (Camel on Spring-Boot): provides uniform access to all other services and orchestrates calls to them.
- Java 8
- Maven 3.5.x
- Your favourite IDE
- HTTPie (to test endpoints)
- Minishift and Openshift client tools (optional)
HTTPie can be installed on Linux, OSX and Windows.
For Windows users: Installation of HTTPie on Windows requires pip that is included in the Python installer.
Read this thread if you need to troubleshoot.
Alternatively, you can use a graphical tool like Postman to test endpoints, but instructions
on this tutorial are given for HTTPie only.
The Minishift requirement is optional. Minishift allows you to start full Openshift pseudo-cluster in your development machine and run your service as containerized images. You can download the binary from the Minishift release page.
Refer to the "quick start guide" to install Minishift on your laptop.
The section about the Openshift client binary explains also how to
include the oc binary into the path in order to interact with the cluster.
Here's how to create the recommendation service.
Here's how to create the credit service.
Here's how to create the inventory service.
Here's how to create the gateway service.
Let's add a circuit breaker and caching logic.
Let's see how to fix inconsistencies.
Let's see how to run everything on Kubernetes and Openshift.