Quarkus Sampler Dokumentáció

Általános

A projekt célja hogy működő használati mintát adjon általános Quarkus projekt felépítésére.

Note	Dokumentáció: https://i-cell-mobilsoft-open-source.github.io/quarkus-sampler/

Használt technológiák

• Coffee 2.0.0+
  JavaEE solution set, melynek célja, hogy az enterprise világ gyakori algoritmusait összegyűjtse, azokra egy alapvető megoldást nyújtson, melyet, ha szükséges saját igényeinkre szabhatunk (https://github.com/i-Cell-Mobilsoft-Open-Source/coffee)
  

• Java 17+

• Maven 3.8.2+

• Jakarta EE 10+

• CDI 4.0+

• Microprofile 6.0+

• Quarkus 3.2.5.Final+

• Tracing with grafana

Tesztelés

A végpontok nem authentikáltak, lehet használni a SwaggerUI oldalát. Sajnos az API "összetettsége" miatt ez az XML formátumban nem fog jól működni a XML namespace miatt, ezért ezt inkább a JSON formátumra használható.

Fejlesztői tesztek - qs-testsuite

qs-testsuite

A fejlesztői tesztek a Roaster projektet használják fel. Ez egy teljesen önnáló REST külső hívásokat végez el a deployolt alkalmazáson. Futtatható egyből a fejlesztői UI (junit pligun) vagy a maven segítségével (aktiválni kell a "profile" kapcsolót), például:

mvn verify -Dprofile (1)
mvn verify -Dprofile=sandbox,local (2)

1. default paraméterek

2. kiválasztott profilok a konfigurációs fájlokból

Release

A release elkészítése automata folyamat, amit a GitHub Actionök kezelnek. Release esetén nem csak maven release készül, hanem docker image is a sampler service-ekről is.

/etc/release/Dockerfile

Alapvetően 3 részből áll:

1. Base image, ami esetünkben egy java 17 image

2. jar fájl lehúzása - nexusból lehúzni a kívánt deployment fájlt

3. dockerimage finalizálása - jar fájlok bele másolása, stb.

/quarkus-sampler/etc/release/docker-compose.yml

Funkciója hogy beállítja a service-k változóit és egyszerre kezelje őket.