search

HBTGmbH / salat

5 stars 1 forks source link

readme

Environment variables

The following environment variables must be set in each environment/stage:

SPRING_DATASOURCE_USERNAME
SPRING_DATASOURCE_PASSWORD
SPRING_DATASOURCE_URL

The following is an example for local testing with the included docker-compose file:

SPRING_DATASOURCE_USERNAME=salattest
SPRING_DATASOURCE_PASSWORD=salattest
SPRING_DATASOURCE_URL=jdbc:mysql://localhost:3306/salat?useUnicode=true&useJDBCCompliantTimezoneShift=true&serverTimezone=Europe/Berlin&useLegacyDatetimeCode=false&autoReconnect=true

Run locally

Steps to start Salat locally:

  1. Build the .war-file: ./mvnw spring-boot:build-image -Dspring-boot.build-image.imageName=docker.io/hbt/salat:latest
  2. Run docker-compose: docker-compose up
  3. Open in browser: http://localhost:8080?employee-sign=<sign>
  4. Valid signs in the test-dataset are: admin, bm, tt

Shutdown:

  1. Stop docker-compose: CTRL+C
  2. Remove built containers: docker-compose down

Login / Logout

Einfach den SALAT mit der URL http://localhost:8080?employee-sign=<sign> aufrufen.

Einfach den SALAT mit der URL http://localhost:8080?logout aufrufen.

Debugging

Start local database only, without Salat: docker-compose -f docker-compose-infra.yml up

! Be sure to remove existing docker containers before by running docker-compose down if you had the application running before.

Troubleshooting

BuildProperties

Falls die Meldung

Consider defining a bean of type 'org.springframework.boot.info.BuildProperties' in your configuration.

kommt. Einfach einmal

mvn package

ausführen. Hintergrund: Maven erzeugt eine Datei build-info.properties. Diese fehlt ggf. weil die IDE (auch mit Maven Integration) diese Datei nicht erzeugt. Bei IntelliJ IDEA bei Klaus wird diese Datei nicht erzeugt.

(by Klaus)

Samlung DB-Änderungen

Datenbankänderungen werden via Liquibase in nachfolgender Datei gepflegt.

src/main/resources/db/changelog/db.changelog-master.yaml

Business-Logiken, die refactored werden sollten, z.B. move to service