nstrug / quarkus-api-example

Quarkus API example

Quarkus REST API with Hibernate ORM, Panache, RESTEasy, and PostgreSQL. Requires JDK 11.

NOTE: Perfoming a native Quarkus build with the packagenative command fails on Eclipse Che Hosted by Red Hat due to the 7GB usage limit.

Endpoints

Method	Endpoint	Description
GET	/food	Lists all Food resources
GET	/food/{id}	Retrieves the Food resource with the specified ID
GET	/food/search/{name}	Retrieves a Food resource with the specified name
GET	/food/restaurant/{restaurantName}	Lists all Food resources with the specified restaurantName
POST	/food	Creates a Food resource

Running within Dev Spaces

Run in development mode

./mvnw compile quarkus:dev

Navigate to localhost:8080/food to view the pre-imported Food resources.

Run tests only

./mvnw test

Packaging the application

./mvnw clean package

Building a JVM-based image

To build a JVM-based image, ./mvnw clean package but be run beforehand.

To build an image, run:

IMG=<IMAGE> && \
podman build -f src/main/docker/Dockerfile.jvm -t $IMG .

To build and push to the local local OpenShift registry, run the following before building:

podman login --tls-verify=false -u kubeadmin -p $(oc whoami -t) image-registry.openshift-image-registry.svc:5000 && \
IMG=image-registry.openshift-image-registry.svc:5000/openshift/quarkus-api-example

Pushing an image

To push an image, run:

podman push $IMG

To push an image to the local OpenShift registry, run:

podman push --tls-verify=false $IMG

Resources

• https://quarkus.io/guides/maven-tooling
• https://quarkus.io/guides/hibernate-orm-panache
• https://quarkus.io/guides/building-native-image