Jenkins anwenden

Warning: Dies ist eine vereinfachte Anleitung. Für produktive Umgebungen sind weitere Sicherheits- und Konfigurationsmaßnahmen erforderlich. Die Anleitung ist nicht erprobt und kann nicht 1:1 umgesetzt werden! (Stand 11.2025)

Eine kurze Erklärung, wie man für ein Spring-Boot-Projekt Jenkins einsetzen kann.

Beispiel RefCard01 mit Jenkins (im Docker-Container) builden, testen, als Image bauen, optional pushen und per SSH mit docker compose deployen.

Die wichtigsten Schritte

1. Jenkins mit Docker-Zugriff starten
   Den Jenkins-Container so starten, dass er den Docker-Socket sieht (oder Docker CLI drin hat).

2. Plugins installieren

   • "Die von Jenkins als üblich empfohlenen Plugins installieren" reicht meist nicht aus.

   • Mindestens folgende Plugins installieren:

     • Pipeline, Git, Git client
     • Docker Pipeline (bzw. Docker Commons + CLI)

     • Credentials Binding

     • Optional:SSH Agent

     • Optional: Blue Ocean

3. User anlegen

4. Credentials anlegen

   • docker-registry-cred (User/Pass oder Token für Registry)
   • docker-registry-url (Secret Text, z. B. https://ghcr.io)
   • deploy-ssh (SSH Private Key für Deploy-Host)

5. Jenkinsfile & Co. ins Repo legen (Root-Verzeichnis)
   

   • README-jenkins-setup.md (Detaillierte Anleitung & Troubleshooting)
   • Jenkinsfile (Pipeline)
   • Dockerfile (für Spring Boot Jar)
   • docker-compose.yml (für Deployment)

6. Pipeline-Job anlegen
   In Jenkins als (Multi-)Branch Pipeline auf dein Repo zeigen. Parameter/Defaults im Job setzen:

   • REGISTRY (z. B. ghcr.io/yourorg oder docker.io/youruser, leer = kein Push)
   • VERSION (leer = automatisch aus Git Tag/Commit)
   • DEPLOY_HOST + DEPLOY_PATH (leer = kein Remote-Deploy)

---

Inhalt wurde mit KI-Unterstützung erstellt.