Entwicklungsumgebung einrichten

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

Paketmanager

Wir installieren alles über einen Paketmanager statt über einzelne Installer. Das spart das manuelle Setzen von JAVA_HOME und Path, und Updates gehen mit einem Befehl.

macOS

Homebrew installieren, falls noch nicht vorhanden:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Windows

Scoop installiert Programme ohne Administratorrechte in den Benutzerordner und setzt Umgebungsvariablen selbst. In einer PowerShell (nicht als Administrator):

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

Scoop braucht Git, um weitere Paketquellen (Buckets) einzubinden. Das JDK liegt im Bucket java:

scoop install git
scoop bucket add java

Alle mit Scoop installierten Programme aktualisieren: scoop update *

Java 25

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

macOS

brew install --cask temurin@25

Installation prüfen:

java -version

Windows

scoop install temurin25-jdk

Scoop setzt dabei auch JAVA_HOME. Danach ein neues Terminal öffnen und prüfen:

java -version

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

scoop install 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

Docker Desktop ist die Ausnahme: Scoop bietet nur die Docker-CLI ohne Engine. Daher den 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

scoop install maven

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.

IntelliJ ist dabei nur ein Fenster auf einen Ordner. Was das für die Arbeit mit Git bedeutet, beschreibt Der Checkout ist nur ein Ordner.