Quick Start

Evento Server and Evento Framework

Evento Server

To start building a RECQ based Architecture you need a Message Gateway to handle and manage message communication between components (microservices). To do this we use Evento Server Introduction.

To start using Evento Server you need a Postgres Database and an instance of Evento Server that you can find on Docker Hub: https://hub.docker.com/r/eventoframework/evento-server

We have also prepared a simple docker-compose.yml to set up your development environment:

version: '3.3'
services:
  evento-db:
    image: 'postgres:latest'
    restart: always
    environment:
      - POSTGRES_PASSWORD=secret
      - POSTGRES_DB=evento
    volumes:
      - ./data/postgres:/var/lib/postgresql/data/
  evento-server:
    image: 'eventoframework/evento-server:latest'
    privileged: true
    restart: on-failure
    depends_on:
      - evento-db
    environment:
      # Cluster name visualized on the GUI
      - evento_cluster_name=evento-server
      # Capture rate for internal telemetry
      - evento_performance_capture_rate=1
      # Telemetry data TTL
      - evento_telemetry_ttl=365
      # Upload directory for Bundle Registration
      - evento_file_upload-dir=/server_upload
      # Secret key used to generate JWT access tokens
      - evento_security_signing_key=MY_JWT_SECRET_TOKEN_SEED
      # Evento Deploy Spawn Script Path
      - evento_deploy_spawn_script=/script/spawn.py
      # Postgres Database Connection Parameters
      - spring_datasource_url=jdbc:postgresql://evento-db:5432/evento
      - spring_datasource_username=postgres
      - spring_datasource_password=secret
    ports:
      - '3000:3000'
      - '3030:3030'
    volumes:
      - ./data/evento/files:/server_upload
      - ./docker-spawn.py:/script/spawn.py

You need to specify a Script for the automatic bundle deployment, add an empty Python script and bind it, it will be fine at the start.

---

Evento Framework

To develop RECQ components you need the Evento Framework Introcution Bundle Library.

Evento Framework is compatible with Java 21 or more.

You can find the library on Maven Central: https://central.sonatype.com/artifact/com.eventoframework/evento-bundle

Gradle

implementation group: 'com.eventoframework', name: 'evento-bundle', version: 'ev1.8.1'

Maven

<dependency>
    <groupId>com.eventoframework</groupId>
    <artifactId>evento-bundle</artifactId>
    <version>ev1.8.1</version>
</dependency>

Evento framework is independent of any other structured known framework like Spring, Micronaut or Quarkus, so you can implement a RECQ application using your preferred technology even plain JavaEE.

---

Tu understands how to use properly Evento Server and Evento Framework we suggest you follow our Tutorial in the next chapter.