aca-java-runtimes-workshop/quarkus-app

Azure Container Apps and Java Runtimes Workshop :: Quarkus

This project uses Quarkus, the Supersonic Subatomic Java Framework.

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

Running the application in dev mode

You can run your application in dev mode that enables live coding using:

./mvnw compile quarkus:dev

NOTE: Quarkus now ships with a Dev UI, which is available in dev mode only at http://localhost:8080/q/dev/.

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/quarkus-app-1.0.0-SNAPSHOT-runner

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

Running the app locally with Docker

First package the app, then run these commands:

docker build -f src/main/docker/Dockerfile.jvm -t "$PROJECT/$QUARKUS_APP:latest" .

docker run -i --rm -p 8701:8701 \
  -e QUARKUS_HIBERNATE_ORM_DATABASE_GENERATION=validate \
  -e QUARKUS_HIBERNATE_ORM_SQL_LOAD_SCRIPT=no-file \
  -e QUARKUS_DATASOURCE_USERNAME="$POSTGRES_DB_ADMIN" \
  -e QUARKUS_DATASOURCE_PASSWORD="$POSTGRES_DB_PWD" \
  -e QUARKUS_DATASOURCE_JDBC_URL="$POSTGRES_DB_CONNECT_STRING" \
  ${PROJECT}/${QUARKUS_APP}:latest

Related Guides

• Hibernate ORM with Panache (guide): Simplify your persistence code for Hibernate ORM via the active record or the repository pattern
• RESTEasy Classic JSON-B (guide): JSON-B serialization support for RESTEasy Classic
• JDBC Driver - PostgreSQL (guide): Connect to the PostgreSQL database via JDBC
• RESTEasy Classic (guide): REST endpoint framework implementing Jakarta REST and more

Provided Code

Hibernate ORM

Create your first JPA entity

Related guide section...

Related Hibernate with Panache section...

RESTEasy JAX-RS

Easily start your RESTful Web Services

Related guide section...