README.md

Simple Quarkus Service

This project uses Quarkus, the Supersonic Subatomic Java Framework. It expose an REST endpoint that return a greeting message.

Running the application

The applicaiton can be run in dev mode with live coding enable using :

./mvnw compile quarkus:dev

The applicaiton can be run in test mode only using:

./mvnw clean test

Packaging the application

The application can be packaged using:

./mvnw package

It produces the quarkus-run.jar file in the target/quarkus-app/ directory.

⚠️ This is not an über-jar as the dependencies are copied into the target/quarkus-app/lib/ directory.

The application can be package in an über-jar using:

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

The über-jar is now runnable using

java -jar target/quarkus-app/quarkus-run.jar.

Creating a native executable

You can create a native executable using:

./mvnw package -Pnative

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

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

The native executable using:

./target/simple-quarkus-service-1.0.0-SNAPSHOT-runner

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

Create an image using podman

Package the code first.

podman build -t [IMAGE_NAME]:[IMAGE_TAG] .

Run the image using podman

podman run --name simple-quarkus -d -p 8080:8080 [IMAGE_NAME]:[IMAGE_TAG]

Stop the container using podman

podman stop simple-quarkus

Delete the container using podman

podman rm simple-quarkus

Define endpoint

The root URL shows the different endpoint and some UI.

Endpoint	Description
/greeting	The default endpoint
/greeting/rhug	Used for the Red Hat user group
/greeting/serverless	Use for the OCP Pipeline demo with Knative serverless