Quick Start

Last updated: 7, July , 2024

Get Started

The recommended way to start using Dagserver is by using a Docker container. You can follow the detailed instructions in this link

Installation

Requirements

To install Dagserver, you must first consider that Dagserver uses a database to store the configurations of the dags programmed inside. By default, Dagserver uses an H2 database, which runs in memory. Additionally, to save the temporary data generated during dag executions, a non-relational repository is used. (MapDB)

Useful Tip:

In a productive context, you should consider installing the Dagserver pointing to an external database. Currently only one installation of MySQL (MariaDB) is supported. This could be configured in the quartz.properties file

Configuration

The following are variables necessary for operation

  • param.folderpath: PATH where the dags implemented using the front will be generated. The generated dags are JAR files that will be stored in this path

Compilation and execution

Dagserver must be compiled using maven. For this, the mvn clean package command must be executed. This will generate the corresponding jar file

Dagserver is implemented using the Springboot framework, so it can be executed in any of the ways supported by the framework. In particular, to run the Jar generated in the previous step, it is recommended to use the following command:

java -jar dagserver-0.7.0-SNAPSHOT.jar

Containers

Within the repository a Dockerfile file and a docker-compose.yml file are made available, which can be used as an example. To set up a test instance of Dagserver, you must clone the repository and use the following command to set up a Docker container:

docker build . -t dagserver --file ./Dockerfile
docker run -d -p 11001:8081 dagserver

If you prefer to use the docker-compose.yml file, you must run the following command to launch the application:

docker-compose up

Credentials

Default frontend:

  • URL: http://: ej: http://localhost:8081
  • Username: dagserver
  • Password: dagserver