Type	Status
CI pipelines
Maintenance
Security
License

This is a template to fast and easily bootstrap new spring boot web applications that including full build based on Gradle, CI based on GitHub actions, and containers based on Docker

For the C4 diagram of the system visit docs/c4/README.md.

The template is a working application with a minimal setup. It contains:

• application skeleton
• setup script to prepare project
• common plugins and libraries
• docker & docker-compose setup
• code quality tools already set up
• integration with GitHub Actions
• integration with Dependabot
• integration with SonarCloudA
• Integration with PostgreSQL, Flyway & Jooq
• Integration with test containers
• integration with CodeQL
• health check, readiness & liveness probs for k8s integration
• OpenApi spec code generation & documentation
• C4 model architecture diagrams
• MIT license and contribution information

Located in ./bin/init.sh. Simply run and follow the explanation how to execute it. This script will self-destroy itself when finished.

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

To run the project you need to install the following:

• JDK 17 or newer
• Docker

The project uses Gradle as a build tool. It already contains ./gradlew wrapper script, so there's no need to install gradle.

To build the project execute the following command:

  ./gradlew build

Create the image of the application by executing the following command:

  ./gradlew assemble

You can run this project directly from Gradle by executing the following command:

./gradlew bootRun

Otherwise, you can create docker image:

  docker compose build

For Apple M1 processor run the following instead:

DOCKER_BUILDKIT=0 docker compose build

Run the distribution (created in spring-starter/build/install/spring-starter directory) by executing the following command:

  docker compose up

This will start the API container exposing the application's port (set to 8080 in this app).

In order to test if the application is up, you can call its health endpoint:

  curl https://localhost:8080/health

You should get a response similar to this:

  {"status":"UP","diskSpace":{"status":"UP","total":249644974080,"free":137188298752,"threshold":10485760}}

Once the service is up, you can access the API documentation from your browser at the following URL: https://localhost:8080/api-docs.

You can use this page as a playground to test the API, and the interactions with the service.

To skip all the setting up and building, just execute the following command:

./bin/run-in-docker.sh

For more information:

./bin/run-in-docker.sh --help

You can run the project tests via Gradle by executing the following command:

./gradlew test

This project uses Spotless Gradle plugin to enforce its code style. The plugin will run automatically after every successful build, test, and assemble stage. However, if you would like to run it manually you can do so by running the following commands:

To apply the code style to the project run:

./gradlew spotlessApply

To check your code without applying any changes you can execute:

./gradlew spotlessCheck

To read more about the plugins included in this project click here.

• OpenJdk 17
• Kotlin
• SpringBoot - The web framework used
• Gradle - Dependency Management
• GitHub Actions - Continuous Integration
• Docker - Container handling

We use SemVer for versioning. For the versions available, see the tags on this repository.

• Yonatan Karp-Rudin - Initial work - yonatankarp