Declarative Pipeline — Jenkinsfile Explained

pipeline {
    // WHERE to run — any available agent/node
    agent any

    // TOOLS needed — must match names in Manage Jenkins > Tools
    tools {
        maven 'Maven-3.9'
        jdk 'JDK-17'
    }

    // ENVIRONMENT VARIABLES — available to all stages
    environment {
        BASE_URL = 'https://www.testerrank.com'
        REPORT_DIR = 'target/allure-results'
    }

    // THE PIPELINE — stages run top to bottom
    stages {
        stage('Checkout') {
            steps {
                // Pull code from the configured Git repo
                checkout scm
            }
        }

        stage('Build') {
            steps {
                // Compile without running tests — catch errors early
                sh 'mvn clean compile -DskipTests'
            }
        }

        stage('Run Tests') {
            steps {
                sh '''
                    mvn test \
                        -DsuiteXmlFile=testng.xml \
                        -Dbase.url=${BASE_URL} \
                        -Dheadless=true
                '''
            }
        }

        stage('Generate Report') {
            steps {
                allure([
                    results: [[path: 'target/allure-results']]
                ])
            }
        }
    }

    // WHAT HAPPENS AFTER — success, failure, or always
    post {
        success {
            echo 'All tests passed!'
        }
        failure {
            echo 'Tests failed. Check the Allure report.'
        }
        always {
            // Publish TestNG results
            testNG(reportFilenamePattern: '**/testng-results.xml')
            // Archive reports
            archiveArtifacts artifacts: 'target/surefire-reports/**',
                             allowEmptyArchive: true
            // Clean workspace
            cleanWs()
        }
    }
}