Hands-on on Quarkus.io demo repository for a enterprise ready library showcase service. The README contains the basic instructions and commands that I used to create the project.
Make sure you have read the prerequisites in https://quarkus.io/guides/getting-started-guide Quarkus currently supports Maven and Gradle as build tools. The Maven plugin currently offers more features, so we are going to use this one.
In order to create this project I issued the following command:
mvn io.quarkus:quarkus-maven-plugin:0.12.0:create \
-DprojectGroupId=cloud.native.quarkus \
-DprojectArtifactId=hands-on-quarkus \
-DclassName="cloud.native.quarkus.LibraryResource" \
-Dpath="/library"
To develop and run the servie continuously, use mvn compile quarkus:dev. To build
it, use mvn package.
mvn compile quarkus:dev -Debug=true
mvn quarkus:list-extensions
mvn quarkus:add-extension -Dextensions="io.quarkus:quarkus-hibernate-orm-panache"
mvn quarkus:add-extension -Dextensions="io.quarkus:quarkus-jdbc-postgresql"
mvn quarkus:add-extension -Dextensions="io.quarkus:quarkus-resteasy-jsonb"
mvn quarkus:add-extension -Dextensions="io.quarkus:quarkus-hibernate-validator"
mvn quarkus:add-extension -Dextensions="io.quarkus:quarkus-smallrye-fault-tolerance"
mvn quarkus:add-extension -Dextensions="io.quarkus:quarkus-smallrye-health"
mvn quarkus:add-extension -Dextensions="io.quarkus:quarkus-smallrye-metrics"
mvn quarkus:add-extension -Dextensions="io.quarkus:quarkus-smallrye-openapi"
One everything is implemented and compiled, we are going to build the package using the following commands:
mvn package -DskipTests
java -jar target/hands-on-quarkus-1.0-SNAPSHOT-runner.jar
Currently, you need a running Postgres database for the tests run. Use the following Docker command to spin up the DB.
docker run --ulimit memlock=-1:-1 -it --rm=true --memory-swappiness=0 --name postgres-quarkus-hibernate -e POSTGRES_USER=quarkus -e POSTGRES_PASSWORD=quarkus -p 5432:5432 postgres:10.5
If you want to build a binary executable then you need Graal VM and call mvn package -Pnative. This takes quite some time so grab a ☕
The containerization can be done on two ways: as normal JVM based application and as a
natively compiled binary. The Dockerfile sources are located in src/main/docker.
Use the following command to build a normal JVM image and run it:
docker build -f src/main/docker/Dockerfile.jvm -t lreimer/hands-on-quarkus:jvm .
docker run -i --rm -p 8080:8080 lreimer/hands-on-quarkus:jvm
To build the native binary image and make it even smaller, use a Quarkus distroless base image. Use the following Dockerfile and put it into src/main/docker/Dockerfile.native.
FROM cescoffier/native-base:latest
WORKDIR /work/
COPY target/*-runner /work/application
EXPOSE 8080
CMD ["./application", "-Dquarkus.http.host=0.0.0.0"]
Then use the following command to build the native image and run it:
mvn package -Pnative -Dnative-image.docker-build=true
docker-compose up --build
docker build -f src/main/docker/Dockerfile.native -t lreimer/hands-on-quarkus:native .
docker run -i --rm -p 8080:8080 lreimer/hands-on-quarkus:native
M.-Leander Reimer (@lreimer), mario-leander.reimer@qaware.de
This software is provided under the MIT open source license, read the LICENSE
file for details.