Description of your service goes here.
(NOTE: This project was instantiated from the Riposte Microservice Template. See that template project's readme for some general details on working with a Riposte project.)
Link to API docs and other relevant info for integrating clients goes here.
The service's main source code lives in the riposte-microservice-template-core-code module.
./gradlew clean build
The template project's "Running the server" section has full details on all your options. Here's a cheat sheet (these are all equivalent).
- Run/debug directly in your IDE. For example in IntelliJ you can just right click on the
com.myorg.Main
class and select eitherRun 'Main.main()'
orDebug 'Main.main()'
from the right-click-menu. Selecting the debug option will let you hit breakpoints immediately without launching a remote debug session.- NOTE: The first time it runs using this launch option it will fail, complaining about the
@appId
and@environment
System properties. You will need to edit the configuration for this launch option to include the-D@appId=riposte-microservice-template -D@environment=local
System properties. But you only need to do this once - any later launches will remember these settings.
- NOTE: The first time it runs using this launch option it will fail, complaining about the
- Run w/ Gradle (no remote debug):
./gradlew run
- Remote debug w/ Gradle (remote debug on port 5005):
./gradlew run --debug-jvm
- Run/remote debug the built fat-jar, a.k.a. shadow jar (remote debug on port 5005):
./debugShadowJar.sh
This project contains "remote tests" that are meant to be executed at the service running somewhere (usually at the deployed service running in test/prod environment, but you can also point them at your service running locally). These remote tests serve as functional tests, integration tests, UATs, smoke tests, or whatever else you want to call them. They live in the riposte-microservice-template-remote-tests module, isolated from the service code.
To execute the remote tests, run the following gradle command:
./gradlew functionalTest -DremoteTestEnv=[environment]
The value of the -DremoteTestEnv=[environment]
System property can be local
, test
, or prod
.
Remote tests should not be confused with "Component Tests", which live in the main core-code module and serve as compile-time integration tests. For more details, see the template project readme sections on Remote Tests and Component Tests.