/hesperides

Configuration management tool providing universal text file templating and properties editing through a REST API or a webapp (backend part)

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

Hesperides backend

Build, test and publish

first-timers-only Friendly -> come look at our good first issues

Hesperides is an open source tool generating configuration files from a given template with mustaches and the properties it stores per environment.

The frontend lives in this repo: https://github.com/voyages-sncf-technologies/hesperides-gui

Development status: this project is currently maintained by e-Voyageurs SNCF.

Live demo

https://hesperides-back.herokuapp.com/rest/swagger-ui.html

Credentials for the Basic Auth:

  • Username: user or prod
  • Password: password

To test the app locally

docker-compose -f docker/docker-compose.yml -f docker/docker-compose-mongo.yml up -d

Requirements

  • Java 11 (correto, openjdk)

Choose between:

  • Docker (see docker-compose & Dockerfile files)

And :

  • MongoDB

Or just launch the application with those Spring Profiles: noldap, fake_mongo

Build

Build the whole project:

mvn package

Build Docker image

docker build . -t hesperides/hesperides

This Java Spring Boot application uses MongoDB for storage and Axon to implement event sourcing.

Logo Spring Boot Logo MongoDB Logo Axon

Documentation

Available online at https://voyages-sncf-technologies.github.io/hesperides-gui/

Changelog

All the last features & fixes are listed there: CHANGELOG.md.

License

Hesperides is licensed under the GPL V3 license

Contributing & development environment installation

Please check the dedicated CONTRIBUTING page. We are open to pull requests. Please first discuss your intentions via Issues.