Entwicklungsumgebung einrichten

Für die Mitarbeit am Projekt werden Java 21, Node.js, Docker, Maven und eine IDE benötigt.

Java 21

Als JDK-Distribution empfehlen wir Eclipse Temurin 21 (OpenJDK, kostenlos, von der Adoptium-Community gepflegt).

macOS

Mit Homebrew:

brew install --cask temurin@21

Installation prüfen:

java -version

Windows

Mit winget:

winget install EclipseAdoptium.Temurin.21.JDK

Danach ein neues Terminal öffnen und prüfen:

java -version

Alternativ den Installer direkt von adoptium.net herunterladen; dieser setzt JAVA_HOME und den PATH automatisch.

Node.js

Für das React-Frontend wird Node.js in der LTS-Version benötigt.

macOS

brew install node

Installation prüfen:

node -v
npm -v

Windows

winget install OpenJS.NodeJS.LTS

Danach ein neues Terminal öffnen und prüfen:

node -v
npm -v

Docker

Docker Desktop stellt sowohl die Docker Engine als auch Docker Compose bereit.

macOS

brew install --cask docker

Anschließend Docker Desktop aus dem Launchpad starten. Docker läuft im Hintergrund als Menüleisten-App.

Windows

Installer von docker.com/products/docker-desktop herunterladen und ausführen.

Docker Desktop benötigt unter Windows das WSL 2-Backend (wird beim Setup automatisch eingerichtet, sofern noch nicht vorhanden).

Installation prüfen:

docker run hello-world

Maven

macOS

brew install maven

Windows

1. Das Binary ZIP von maven.apache.org/download.cgi herunterladen und z. B. nach C:\Program Files\Maven entpacken.
2. Systemumgebungsvariable MAVEN_HOME auf diesen Ordner setzen.
3. %MAVEN_HOME%\bin zur Umgebungsvariable Path hinzufügen.
4. Ein neues Terminal öffnen und prüfen:

mvn -version

Alternativ beschreibt maven.apache.org/install.html die Installation über Chocolatey oder Scoop.

Installation prüfen:

mvn -version

CIB seven Maven Repository einrichten

Pflichtschritt für CIB seven Services

Das CIB seven Enterprise Repository ist nicht öffentlich zugänglich. Ohne diese Konfiguration schlägt der Maven-Build aller Services fehl, die auf dem cibseven-template basieren. Zugangsdaten (Kundennummer + Passwort) beim Dozenten erfragen.

Die Zugangsdaten werden einmalig in ~/.m2/settings.xml hinterlegt:

In <servers> einfügen:

<server>
  <id>mvn-cibseven-enterprise</id>
  <username>KUNDENNUMMER</username>
  <password>PASSWORT</password>
</server>

In <profiles> einfügen:

<profile>
  <id>cibseven-ee</id>
  <repositories>
    <repository>
      <id>mvn-cibseven-enterprise</id>
      <name>CIB seven Enterprise repository</name>
      <url>https://artifacts.cibseven.org/repository/enterprise-group/</url>
    </repository>
  </repositories>
</profile>

In <activeProfiles> einfügen:

<activeProfile>cibseven-ee</activeProfile>

IDE: IntelliJ IDEA

Wir empfehlen IntelliJ IDEA als Entwicklungsumgebung. Die Community Edition ist kostenlos und für dieses Projekt ausreichend. Allerdings fehlen sehr komfortable Features zum Entwickeln mit Spring und Quarkus. Daher sollte die Ultimate Edition verwendet werden.

Als Studierende der THI besteht Anspruch auf die Ultimate Edition, kostenlos über das JetBrains Student Program.

IntelliJ erkennt Maven-Projekte automatisch beim Öffnen und bringt ein integriertes Terminal, Git-Unterstützung und Debugger für Spring Boot mit. Das JDK kann direkt in IntelliJ unter File → Project Structure → SDK verwaltet werden.