Eventhos is an open source platform that applies event-driven architecture principles to allow the user to orchestrate their system integrations using a simple user interface instead of complicated publisher and subscriber source codes in applications. You only need webhooks and rest APIs to integrate all your systems.

Full details in the wiki

Basically you have to identify the producers (webhooks) and consumers (apis). Then using th UI you can make a contract between the incoming event produced by a webhook (source system) to the rest api in in the target system. So with this you will have a real time integration between the producer and consumer systems without the complexity of kafka or similars.

Here a sample of contract between producers and consumers

More uses cases and deep explanation here and here

• Register all systems (producers and consumers)
• Create contracts between your systems
• Oauth2 Security
• Manual retry on error
• Event Dashboard to see the received events and all the details (request/response)
• Reply-To option
• Json binding to match between the webhook json and target api json
• Vanilla javascript to binding to match between the webhook json and target api json
• Mail on error with the details
• User Management

More details here

Here a minimalist High Level Diagram

To know more about each dependency check their git repositories.

• eventhos-api
• eventhos-web

• docker
• docker compose

For windows users, check https://github.com/usil/eventhos/wiki/Windows-Users

The aim of this repository is to server as starting point or one click method to start all the eventhos artifacts or dependencies. Chose one of the following options.

Is recomended to deploy each artifact on its own host instead of all in one host. This is only for local tests or run the integration tests. Check the deployment section to know hot to deploy it in aws, gcp, azure, etc

default secrets

bash one_click.sh build=true  latest_branch=true custom_composer_file=docker-compose.yml 

Run this anytime you need to get the lastest version

custom secrets

Add the param config_mode=expert

bash one_click.sh build=true  latest_branch=true custom_composer_file=docker-compose.yml config_mode=expert 

bash one_click.sh build=true  latest_branch=true custom_composer_file=docker-compose.yml skip_database=true

bash one_click.sh build=true  latest_branch=true custom_composer_file=docker-compose.yml force_clean_startup=true

This will delete the mysql data in ${HOME}/mysql_eventhos folder

Be careful!!!

bash one_click.sh latest_branch=true custom_composer_file=docker-compose.yml service_to_update=eventhos-web operation=update

bash one_click.sh  custom_composer_file=docker-compose-integration-tests.yml  build=true latest_branch=true

If everting worked go to http://localhost:2110 and you will see this:

In a command line:

First access to eventhos-api in docker.

docker exec -it eventhos-api cat /tmp/credentials.txt

Then you will get your credentials

User:
admin
Password:
SVEvoxC55WclE47hX8ysXFWLh1Qf9oRN
clientid:
CDCsjgE9PbqLnTzZcjmU::usil.app
clientsecret:
QxYOwrpicnKCYyV1lXGhMoUL2JyUbMTr

docker exec -it eventhos-db bash /usr/local/bin/manage.sh operation=export_db user=root database_name=eventhos

Luis Huertas

JRichardsz