Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/fugerit-org/quarkus-photobook

Quarkus photobook demo, using mongo db for persistence
https://github.com/fugerit-org/quarkus-photobook
Last synced: 13 days ago
JSON representation
Quarkus photobook demo, using mongo db for persistence
Host: GitHub
URL: https://github.com/fugerit-org/quarkus-photobook
Owner: fugerit-org
License: mit
Created: 2024-06-12T12:59:34.000Z (7 months ago)
Default Branch: main
Last Pushed: 2024-10-09T11:36:03.000Z (3 months ago)
Last Synced: 2024-11-06T01:10:13.156Z (2 months ago)
Language: Java
Homepage:
Size: 1.31 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project

README

        # Quarkus Photobook Demo App

[![Keep a Changelog v1.1.0 badge](https://img.shields.io/badge/changelog-Keep%20a%20Changelog%20v1.1.0-%23E05735)](https://github.com/fugerit-org/quarkus-photobook/blob/master/CHANGELOG.md)

[![license](https://img.shields.io/badge/License-Apache%20License%202.0-teal.svg)](https://opensource.org/licenses/Apache-2.0)

[![code of conduct](https://img.shields.io/badge/conduct-Contributor%20Covenant-purple.svg)](https://github.com/fugerit-org/fj-universe/blob/main/CODE_OF_CONDUCT.md)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=fugerit-org_quarkus-photobook&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=fugerit-org_quarkus-photobook)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=fugerit-org_quarkus-photobook&metric=coverage)](https://sonarcloud.io/summary/new_code?id=fugerit-org_quarkus-photobook)

[![Docker images](https://img.shields.io/badge/dockerhub-images-important.svg?logo=Docker)](https://hub.docker.com/repository/docker/fugeritorg/quarkus-photobook/general)

## Introduction

Recently I followed some [Mongo DB courses](https://learn.mongodb.com/) and attended the [Spring I/O 2023](https://2023.springio.net/).  

So I decided to practice a bit. This project is the result.  

Currently is just a simple POC integration of Mongo DB and Quarkus

There is a live version at the link [https://springio23.fugerit.org/photobook-demo/home/index.html](https://springio23.fugerit.org/photobook-demo/home/index.html)

This is an alternate version of the [springboot project](https://github.com/fugerit-org/springboot-photobook/) based on [quarkus](https://quarkus.io/)

## Prerequisites

| software                                                                                                                                                                                                 | docker compose | local build and run |

|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------|---------------------|

| [![Java runtime version](https://img.shields.io/badge/run%20on-java%2021+-%23113366.svg?style=for-the-badge&logo=openjdk&logoColor=white)](https://universe.fugerit.org/src/docs/versions/java21.html)   | no             | yes                 |

| [![Java build version](https://img.shields.io/badge/build%20on-GraalVM%2021+-%23ED8B00.svg?style=for-the-badge&logo=openjdk&logoColor=white)](https://universe.fugerit.org/src/docs/versions/gvm21.html) | no             | yes                 |

| [![Apache Maven](https://img.shields.io/badge/Apache%20Maven-3.9.0+-C71A36?style=for-the-badge&logo=Apache%20Maven&logoColor=white)](https://universe.fugerit.org/src/docs/versions/maven3_9.html)       | no             | yes                 |

| [![Node JS](https://img.shields.io/badge/Node%20JS-20+-1AC736?style=for-the-badge&logo=node.js&logoColor=white)](https://universe.fugerit.org/src/docs/versions/node.html)                               | no             | yes                 |

| [![Docker](https://img.shields.io/badge/docker-26+-1266E7?style=for-the-badge&logo=docker&logoColor=white)](https://universe.fugerit.org/src/docs/versions/docker.html)                                  | yes            | no                  |

## Quickstart 

### Start via docker compose

```shell

docker-compose -f src/main/docker/docker-compose.yml up -d

```

### Start in dev mode

1. Create mongo db instance with db initialization (script src/test/resources/mongo-db/mongo-init.js) :

```shell

docker run --rm -p 27017:27017 --name MONGO8 -v `pwd`/src/test/resources/mongo-db/mongo-init.js:/docker-entrypoint-initdb.d/mongo-init.js mongo:8.0.0-rc8

```

This will start a mongo db linked on the default port and with the default username/password (root/example).

2. Start the application in dev mode

The back end

```shell

mvn quarkus:dev

```

And front end

```shell

cd src/main/react

npm install

npm run start

```

3. Access home page

## project environment variables

In case you want a custom mongo db connection :

| key         | dedault                                  | 

|-------------|------------------------------------------|

| MONGODB_URL | mongodb://localhost:27017/photobook_demo |

## container environment variables

Other custom environment variables :

| key              | dedault | description                                 |

|------------------|---------|---------------------------------------------|

| JAVA_OPTS_APPEND |         | append java options (for instance '-Xmx1g') |

For the Dockefile.jvm build, see the [RedHat UBI OpenJDK image documentation](https://jboss-container-images.github.io/openjdk/) for more options.

## Quarkus package

It is possible to compile the application to a single jar package :

```shell

mvn package -Pbuildreact

```

And then run

```shell

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

```

## Native image compilation

The code has been set for native compilation with [GraalVM](https://www.graalvm.org/) (tested with GraalVM 22.3 CE).  

It is possible to compile :

```shell

mvn install -Dnative -Pbuildreact

```

And then run

```shell

./target/quarkus-photobook*-runner

```

Refer to [Quarkus Documentation](https://quarkus.io/guides/building-native-image) for more informations.

## Docker image

### docker container (jvm)

Build quarkus application (jar)

```shell

mvn package -P buildreact

```

Build container openjdk

```shell

docker build -t quarkus-photobook-jvm -f src/main/docker/Dockerfile.jvm .

```

Running the container :

```shell

docker run -it -p 8080:8080 --name quarkus-photobook-jvm quarkus-photobook-jvm

```

### docker container (native)

Building the native image :

```shell

mvn -Dnative -Pbuildreact

```

Building the container image : 

```shell

docker build -t quarkus-photobook-native -f src/main/docker/Dockerfile.native .

```

Running the container :

```shell

docker run -it -p 8080:8080 --name quarkus-photobook-native quarkus-photobook-native

```

## Native optimization : PGO

This section is based on .

One of the most powerful performance optimizations in Native Image is profile-guided optimizations (PGO).

1. Build an instrumented image:

```shell

mvn package -Dnative -Pinstrumented

```

2. Run the app and apply relevant workload:

```shell

mv ./target/quarkus-photobook*runner ./target/quarkus-photobook-instrumented

```

```shell

./target/quarkus-photobook-instrumented

```

```shell

hey -n=30000 http://localhost:8080/photobook-demo/api/photobook/view/list

```

```shell

hey -n=30000 http://localhost:8080/photobook-demo/api/photobook/view/images/springio23/language/it/current_page/1/page_size/5

```

after you shut down the app, you'll see an `iprof` file in your working directory.

3. Build an app with profiles (they are being picked up via `--pgo=${project.basedir}/default.iprof`):

```shell

mvn package -Dnative -Poptimized

```

## Benchmark scripts

Prerequisites :

- running mongo db

- `hey` installed

- `psrecord` installed

At the end of a run, an image will be plotted in the `target` folder.

### 1. Benchmark JIT

```shell

mvn clean package

```

```shell

./src/main/script/bench-jit.sh

```

### 2. Benchmark native

Follow steps in 'Native optimization : PGO' section

```shell

./src/main/script/bench-native.sh

```

### 3. Benchmark result

Sample result of JIT benchmark run :

![JIT Benchmark Result](src/main/docs/images/bench-result-jit-20240617.png)

Sample result of native (AOT) benchmark run :

![Native Benchmark Result](src/main/docs/images/bench-result-native-20240617.png)

## application stack

| Layer             | 2024 version   |

|-------------------|----------------|

| Persistence       | MongoDB 8      |

| Java version      | GraalVM 21     |

| API REST          | Quarkus 3.11.x |

| Node JS           | Node 20        |

| Front end package | Vite           |

| Front end UI      | React 18.3     |

## Deploy on Google App Engine

Prerequisites :

* google cloud account

* GCloud CLI

[Simple app.yaml for AOT](src/main/appengine/app-aot.yaml) and

[Simple app.yaml for JIT](src/main/appengine/app-jit.yaml)

Customize the app.yaml and run gcloud 

For JIT version the uber kar packaging is needed : 

```shell

mvn package -Dquarkus.package.jar.type=uber-jar

```

```shell

gcloud quarkus-photobook-runner.jar --appyaml=src/main/appengine/app-jit.yaml

```

For JIT version or

```shell

gcloud quarkus-photobook-runner --appyaml=src/main/appengine/app-aot.yaml

```

For AOT version

Further reference : 

* 

* 

## Deploy on KNative

Prerequisites : 

* container environment (docker / podman)

* Kubernates (for instance minikube)

* Knative

After setting up Knative, 

Customize the [quarkus-photobook-jit.yaml](quarkus-photobook-jit.yaml) or

[quarkus-photobook-aot.yaml](quarkus-photobook-aot.yaml) service deployment.

And run

```shell

kubectl apply -f quarkus-photobook-jit.yaml

```

For JIT version or

```shell

kubectl apply -f quarkus-photobook-aot.yaml

```

For AOT version