getting-started-dev-services

This project uses Quarkus, the Supersonic Subatomic Java Framework.

If you want to learn more about Quarkus, please visit its website: https://quarkus.io/.

It demonstrates how to provide datasource credential using Quarkus Amazon Services Secret Manager client.

Running the application in dev mode

This application will not use Dev Services for postgresql. Start an instance with docker

docker run --name some-postgres -e POSTGRES_USER=quarkus -e POSTGRES_PASSWORD=quarkus -d -p 5432:5432 postgres

Then, you can run the application in dev mode that enables live coding using:

./mvnw compile quarkus:dev

Visit http://localhost:8080/hello/names

curl  http://localhost:8080/hello/names

It should show I've said hello to Alice, Bob

Packaging and running the application

The application can be packaged using:

./mvnw package

It produces the quarkus-run.jar file in the target/quarkus-app/ directory. Be aware that it’s not an über-jar as the dependencies are copied into the target/quarkus-app/lib/ directory.

The application is now runnable using java -jar target/quarkus-app/quarkus-run.jar.

If you want to build an über-jar, execute the following command:

./mvnw package -Dquarkus.package.jar.type=uber-jar

The application, packaged as an über-jar, is now runnable using java -jar target/*-runner.jar.

Creating a native executable

You can create a native executable using:

./mvnw package -Dnative

Or, if you don't have GraalVM installed, you can run the native executable build in a container using:

./mvnw package -Dnative -Dquarkus.native.container-build=true

You can then execute your native executable with: ./target/getting-started-dev-services-1.0.0-SNAPSHOT-runner

If you want to learn more about building native executables, please consult https://quarkus.io/guides/maven-tooling.

Related Guides

• REST (guide): A Jakarta REST implementation utilizing build time processing and Vert.x. This extension is not compatible with the quarkus-resteasy extension, or any of the extensions that depend on it.
• Quarkus Amazon Services Secret Manager (guide)
• Using a Credentials Provider (guide)