PIT-Mutation-Coverage und Cucurrent Builds konfiguriert

Jenkinsfile

@@ -8,6 +8,10 @@
 pipeline {
     agent any
 
+    options {
+        disableConcurrentBuilds()
+    }
+
     tools {
         maven 'maven-3'
     }
@@ -16,66 +20,92 @@ pipeline {
     // BUILD_NUMBER wird automatisch durch Jenkins vergeben.
     // Die resultierende Versionsnummer lautet: MAJOR.MINOR.BUILD_NUMBER
     parameters {
-        string(
+        string(name: 'MAJOR', defaultValue: '3', description: 'SemVer MAJOR (manuell)')
-            name: 'MAJOR',
+        string(name: 'MINOR', defaultValue: '0', description: 'SemVer MINOR (manuell)')
-            defaultValue: '3',
-            description: 'Hauptversionsnummer (manuell pflegen)'
-        )
-        string(
-            name: 'MINOR',
-            defaultValue: '0',
-            description: 'Nebenversionsnummer (manuell pflegen)'
-        )
-    }
-
-    environment {
-        // Effektive Versionsteile – übernommen aus Parametern oder State-Datei.
-        // Hinweis: Wenn MAJOR/MINOR aus einer persistierten State-Datei gelesen
-        // werden sollen (z. B. /builds/version.state), muss die Logik unten in
-        // der Stage 'Version bestimmen' entsprechend ergänzt werden.
-        // Im Minimalbetrieb werden die Parameter direkt übernommen.
-        EFFECTIVE_MAJOR = "${params.MAJOR}"
-        EFFECTIVE_MINOR = "${params.MINOR}"
     }
 
     stages {
 
-        // Optionaler Stub: MAJOR/MINOR aus persistierter State-Datei laden.
-        // Wenn das bestehende Jenkins-Setup die Versionsnummern in einer
-        // State-Datei unter /builds/version.state persistiert, kann diese
-        // Stage die Umgebungsvariablen EFFECTIVE_MAJOR und EFFECTIVE_MINOR
-        // vor dem Build überschreiben. Ansonsten gelten die Parameter-Werte.
         stage('Version bestimmen') {
             steps {
                 script {
-                    // Platzhalter: hier bei Bedarf State-Datei einlesen,
+                    def isManual = !currentBuild.getBuildCauses('hudson.model.Cause$UserIdCause').isEmpty()
-                    // z. B.:
+                    def jenkinsHome = env.JENKINS_HOME ?: '/var/jenkins_home'
-                    //   def state = readFile('/builds/version.state').trim()
+                    def safeJobName = env.JOB_NAME.replaceAll(/[^A-Za-z0-9._-]/, '_')
-                    //   env.EFFECTIVE_MAJOR = state.split('\\.')[0]
+                    def stateDir = "${jenkinsHome}/version-state"
-                    //   env.EFFECTIVE_MINOR = state.split('\\.')[1]
+                    def stateFile = "${stateDir}/${safeJobName}.properties"
-                    //
+
-                    // Im Minimalbetrieb werden die Parameter-Werte verwendet:
+                    if (isManual) {
-                    echo "Buildversion: ${env.EFFECTIVE_MAJOR}.${env.EFFECTIVE_MINOR}.${env.BUILD_NUMBER}"
+                        env.EFFECTIVE_MAJOR = params.MAJOR
+                        env.EFFECTIVE_MINOR = params.MINOR
+
+                        sh """
+                          mkdir -p '${stateDir}'
+                          cat > '${stateFile}' <<'EOF'
+MAJOR=${params.MAJOR}
+MINOR=${params.MINOR}
+EOF
+                        """
+
+                        echo "Manueller Build erkannt. Version gespeichert: ${env.EFFECTIVE_MAJOR}.${env.EFFECTIVE_MINOR}"
+                    } else {
+                        def stateExists = (sh(script: "[ -f '${stateFile}' ]", returnStatus: true) == 0)
+
+                        if (stateExists) {
+                            env.EFFECTIVE_MAJOR = sh(
+                                script: "grep '^MAJOR=' '${stateFile}' | cut -d= -f2-",
+                                returnStdout: true
+                            ).trim()
+
+                            env.EFFECTIVE_MINOR = sh(
+                                script: "grep '^MINOR=' '${stateFile}' | cut -d= -f2-",
+                                returnStdout: true
+                            ).trim()
+
+                            echo "Automatischer Build erkannt. Gespeicherte Version verwendet: ${env.EFFECTIVE_MAJOR}.${env.EFFECTIVE_MINOR}"
+                        } else {
+                            env.EFFECTIVE_MAJOR = params.MAJOR
+                            env.EFFECTIVE_MINOR = params.MINOR
+
+                            echo "Automatischer Build ohne gespeicherten Stand. Fallback auf Parameter: ${env.EFFECTIVE_MAJOR}.${env.EFFECTIVE_MINOR}"
+                        }
+                    }
+
+                    currentBuild.displayName = "#${env.BUILD_NUMBER} ${env.EFFECTIVE_MAJOR}.${env.EFFECTIVE_MINOR}"
                 }
             }
-        }
+        } // stage: Version bestimmen
 
         stage('Maven Build') {
             steps {
-                // -Drevision übergibt die vollständige Versionsnummer an Maven.
+                catchError(buildResult: 'FAILURE', stageResult: 'FAILURE') {
-                // Das flatten-maven-plugin im Parent-POM löst ${revision} in
+                    // -Drevision übergibt die vollständige Versionsnummer an Maven.
-                // allen installierten POMs auf, sodass kein unaufgelöstes
+                    // Das flatten-maven-plugin im Parent-POM löst ${revision} in
-                // ${revision} in ~/.m2 verbleibt.
+                    // allen installierten POMs auf.
-                sh "mvn clean verify -Drevision=${env.EFFECTIVE_MAJOR}.${env.EFFECTIVE_MINOR}.${env.BUILD_NUMBER}"
+                    sh "mvn clean verify -Drevision=${env.EFFECTIVE_MAJOR}.${env.EFFECTIVE_MINOR}.${env.BUILD_NUMBER}"
+                }
             }
-        }
+        } // stage: Maven Build
+
+        stage('Publish PIT Coverage') {
+            steps {
+                recordCoverage(
+                    tools: [[
+                        parser: 'PIT',
+                        pattern: '**/target/pit-reports/mutations.xml'
+                    ]],
+                    id: 'pit',
+                    name: 'PIT Mutation Coverage',
+                    failOnError: true
+                )
+            }
+        } // stage: Publish PIT Coverage
 
         stage('Archive JAR') {
             steps {
-                // Bash wird explizit erzwungen (#!/usr/bin/env bash, set -euo pipefail),
+                // Bash wird explizit erzwungen, weil Jenkins-Agenten standardmäßig
-                // weil Jenkins-Agenten standardmäßig sh (dash) verwenden, das kein
+                // sh (dash) verwenden, das kein mapfile kennt. mapfile zählt exakt
-                // mapfile kennt. mapfile zählt exakt die gefundenen Shade-JARs und
+                // die gefundenen Shade-JARs und bricht ab, wenn nicht genau eines vorhanden ist.
-                // bricht den Build ab, wenn nicht genau eines vorhanden ist.
                 sh '''#!/usr/bin/env bash
 set -euo pipefail
 
@@ -92,25 +122,10 @@ echo "Shade-JAR archiviert als: $JAR_NAME"
 '''
                 archiveArtifacts artifacts: 'pdf-ki-renamer-*.jar', fingerprint: true
             }
-        }
+        } // stage: Archive JAR
-
-        stage('Berichte') {
-            steps {
-                // JUnit-Testergebnisse einlesen
-                junit testResults: '**/target/surefire-reports/*.xml', allowEmptyResults: true
-
-                // JaCoCo-Coverage (falls im Build erzeugt)
-                // jacoco execPattern: '**/target/jacoco.exec'
-
-                // PIT-Mutationstest-Bericht (falls im Build erzeugt)
-                // publishHTML(target: [reportDir: 'target/pit-reports', ...])
-            }
-        }
 
         stage('Artefakt ablegen') {
             steps {
-                // JAR-Kopie in zentrales Build-Verzeichnis ablegen.
-                // Pfad /builds/ muss auf dem Jenkins-Agent gemountet sein.
                 sh '''#!/usr/bin/env bash
 set -euo pipefail
 
@@ -120,19 +135,39 @@ cp pdf-ki-renamer-*.jar "$BUILD_DIR/"
 echo "Artefakt abgelegt unter: $BUILD_DIR"
 '''
             }
-        }
+        } // stage: Artefakt ablegen
+
+        stage('Berichte veröffentlichen') {
+            steps {
+                junit testResults: '**/target/surefire-reports/*.xml', allowEmptyResults: true
+
+                recordCoverage(
+                    tools: [[parser: 'JACOCO', pattern: 'pdf-umbenenner-coverage/target/site/jacoco-aggregate/jacoco.xml']],
+                    enabledForFailure: true
+                )
+
+                publishHTML(target: [
+                    reportName: 'JaCoCo HTML Report',
+                    reportDir: 'pdf-umbenenner-coverage/target/site/jacoco-aggregate',
+                    reportFiles: 'index.html',
+                    keepAll: true,
+                    alwaysLinkToLastBuild: true,
+                    allowMissing: true
+                ])
+            }
+        } // stage: Berichte veröffentlichen
 
         stage('Aufräumen') {
             steps {
-                // Lokale JAR-Kopie im Workspace entfernen (Artefakt ist archiviert)
                 sh '''#!/usr/bin/env bash
 set -euo pipefail
 rm -f pdf-ki-renamer-*.jar
 echo "Aufräumen abgeschlossen."
 '''
             }
-        }
+        } // stage: Aufräumen
-    }
+
+    } // stages
 
     post {
         success {
@@ -142,8 +177,8 @@ echo "Aufräumen abgeschlossen."
             echo "Build ${env.EFFECTIVE_MAJOR}.${env.EFFECTIVE_MINOR}.${env.BUILD_NUMBER} fehlgeschlagen."
         }
         always {
-            // Workspace nach Abschluss bereinigen
             deleteDir()
         }
     }
-}
+
+} // pipeline