Self-Contained System mit Spring-Boot und Svelte-UI

Projekte

app/backend-api

Datenmodell für den Spring-Boot-Server der Anwendung.

https://projectlombok.org/

https://github.com/FasterXML/jackson-docs

app/backend

REST-API für den Spring-Boot-Server der Anwendung.

https://spring.io/projects/spring-framework

https://spring.io/projects/spring-restdocs

https://spring.io/projects/spring-data-jpa

https://spring.io/projects/spring-data-rest

https://docs.liquibase.com/home.html

app/server

Spring-Boot-Server der Anwendung mit einer HSQL-Datenbank.

https://spring.io/projects/spring-boot

http://hsqldb.org

app/client

Browser-basierter Svelte-Client der Anwendung.

https://svelte.dev

https://tailwindcss.com

https://visionmedia.github.io/page.js

https://vitejs.dev

app/deploy

Deployment der Anwendung in einem Kubernetes-Cluster.

https://kubernetes.io

https://docs.docker.com/desktop/kubernetes

https://github.com/kubernetes/kubectl

https://github.com/kubernetes/ingress-nginx

https://github.com/kubernetes/dashboard

https://helm.sh

Häufig gestellte Fragen

Code bauen und testen

./gradlew clean build

Code formatieren

./gradlew spotlessApply

Spring-Boot-Server lokal starten

./gradlew app:server:bootRun

Der Befehl startet den Server als Java-Anwendung. Die Anwendung wird im Browser mit localhost:8080 aufgerufen.

Mit der Umgebungsvariable LOGGING_LEVEL_ORG_HIBERNATE_TYPE kann die Ausgabe von Typinformationen gesteuert werden. Mit dem Wert TRACE werden bspw. die aktuellen Parameter von Statements ausgegeben.

Mit der Umgebungsvariable LOGGING_LEVEL_ORG_HIBERNATE_STAT kann die Ausgabe von Statistiken gesteuert werden. Mit dem Wert DEBUG werden bspw. die Kennzahlen von Statements ausgegeben.

./gradlew app:server:dockerRun

Der Befehl startet den Server als Docker-Container. Die Anwendung wird im Browser mit localhost:8080 aufgerufen.

Svelte-Client lokal starten

npm run dev

Der Befehl startet den Client als Node-Anwendung. Die Anwendung wird im Browser mit localhost:5000 aufgerufen.

./gradlew app:client:dockerRun

Der Befehl startet den Client als Docker-Container. Die Anwendung wird im Browser mit localhost:5000 aufgerufen.

Dokumentation lokal bauen

./gradlew asciidoctor

Die Dokumentation befindet sich im pages-Ordner.

Kubernetes-Cluster lokal einrichten

Docker-Desktop richtet auf localhost einen Kubernetes-Cluster ein.

Kubernetes-Ingress lokal einrichten

./gradlew deployIngress

Der Ingress-Service wird installiert und gestartet.

Kubernetes-Dashboard lokal einrichten

./gradlew deployDashboard

Das Dashboard wird installiert und gestartet. Beim ersten Aufruf muss ein Token eingegeben werden. Das Token ist zeitlich befristet. Ein gültiges Token wird mit mit dem Aufruf von

./gradlew createDashboardToken

erstellt.

kubectl proxy

Der Befehl startet den Proxy auf dem lokalen Host. Das Dashboard wird im Browser mit der zuvor angezeigte URL aufgerufen.

Kubernetes-Deployment lokal ausführen

./gradlew deploy

Die Anwendung wird im Browser mit localhost aufgerufen.

Kubernetes-Deployment lokal entfernen

./gradlew undeploy