Library application

Sample Spring Boot cloud-native application written in TDD style.

Local run

The easiest way to run application locally is to use LocalLibraryApplication class. It will run all needed dependencies in the Docker containers and configure application to use them automatically.

Configuration

To enable Actuator endpoints admin profile has to be activated with proper secrets provided via system properties or other suitable external configuration option:

-Dspring.security.user.name=admin -Dspring.security.user.password=xpinjection -Dspring.profiles.active=dev,admin

Consumer-driven contracts

Pact is used to describe and manage REST API contracts.

Sample instance of the Pact Broker in Docker could be started with /pact/docker-compose.yaml. It starts the Pact Broker and the PostgreSQL database as dependency. Data is not stored on volumes, so will be cleaned after restart.

Pact integration could be enabled during tests execution with pactbroker.enabled system property.

Use system variable pact.verifier.publishResults to control pact verification results publishing to the Pact Broker. Pact Broker configuration is located in pom.xml and could be overridden with system properties as well.

System properties pact.provider.version and pact.provider.branch should be used to pass correct version of the application and git branch for tracking in the Pact Broker.

Skipping Testcontainers based tests

Tests that rely on Testcontainers can be disabled by setting system property testcontainers.enabled to false:

./mvnw verify -Dtestcontainers.enabled=false