Tomcat-Embedded-OpenApi

Requirements

Software:

• OpenJDK 20 with OpenJ9 -> https://developer.ibm.com/languages/java/semeru-runtimes/downloads/
• Docker 4.28.0 -> https://docs.docker.com/desktop/install/ubuntu/

Configure JDK VSCode:

Change /.vscode/launch.json for your Java Home

Configure JDK Gradle:

Change gradle.properties for your Java Home

Environment variables:

• DB_URL=localhost:5432/postgres
• DB_USER=postgres
• DB_PASS=mysecretpassword

Start PostgreSQL

docker run --name tomcat-openapi-postgres -p 5432:5432 -e POSTGRES_PASSWORD=mysecretpassword -d postgres:16.3-alpine3.18

Start application

DB_URL="localhost:5432/postgres" DB_USER=postgres DB_PASS=mysecretpassword ./gradlew run

Development

Visual Studio Code Extensions:

Extension Pack for Java

Install "Extension Pack for Java" from Microsoft: https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-pack

Gradle Extension Pack

Install "Gradle Extension Pack" from Richard Willis https://marketplace.visualstudio.com/items?itemName=richardwillis.vscode-gradle-extension-pack

Endpoints

Name	Endpoint
Service Info	http://localhost:8080/

Observability

Start Docker Grafana OTEL

docker run --restart unless-stopped --detach --publish 3000:3000 --publish 4317:4317 --publish 4318:4318 --name grafana_otel grafana/otel-lgtm:0.11.0

Ref: https://hub.docker.com/r/grafana/otel-lgtm

View Grafana

Log in to http://localhost:3000 with user admin and password admin.