Auslösen von Jenkins-Builds aus der Ferne und Übergeben von Parametern

Ich rufe einen Jenkins-Job remote auf und verwende Folgendes:

wget http://<ServerIP>:8080/job/Test-Jenkins/build?token=DOIT

Hier wird der Test-JenkinsJob aufgerufen und DOITist das Sicherheitstoken, das ich verwendet habe.

Jetzt muss ich einige Parameter an die Datei build.xml dieses Jobs übergeben, z Test-Jenkins.

Ich habe noch nicht herausgefunden, wie die Variablen übergeben werden sollen.

Siehe Jenkins Dokumentation: Parametrisierter Build

Unten ist die Zeile, die Sie interessiert:

http://server/job/myjob/buildWithParameters?token=TOKEN&PARAMETER=Value

Aktivieren Sie in Ihrer Jenkins-Jobkonfiguration das Kontrollkästchen " This build is parameterized", klicken Sie auf die Add ParameterSchaltfläche " " und wählen Sie den String ParameterDropdown-Wert " " aus.

Definieren Sie nun Ihren Parameter - Beispiel:

Jetzt können Sie Ihren Parameter in Ihrer Job- / Build-Pipeline verwenden. Beispiel:

Rufen Sie als Nächstes die folgende URL auf (entweder POST oder GET), um den Build mit einem eigenen / benutzerdefinierten Parameter auszulösen:

http://JENKINS_SERVER_ADDRESS/job/YOUR_JOB_NAME/buildWithParameters?myparam=myparam_value

Um diese Frage zu ergänzen, habe ich herausgefunden, dass Sie den /buildWithParametersEndpunkt nicht verwenden müssen .

In meinem Szenario habe ich ein Skript, das Jenkins dazu veranlasst, nach einer Bereitstellung Tests auszuführen. Für einige dieser Tests sind zusätzliche Informationen zur Bereitstellung erforderlich, damit sie ordnungsgemäß funktionieren.

Wenn ich versuchen würde, /buildWithParameterseinen Job zu verwenden, der keine Parameter erwartet, wird der Job nicht ausgeführt. Ich möchte nicht jeden Job bearbeiten, um gefälschte Parameter zu benötigen, damit die Jobs ausgeführt werden.

Stattdessen habe ich festgestellt, dass Sie Parameter wie folgt übergeben können:

curl -X POST --data-urlencode "token=${TOKEN}" --data-urlencode json='{"parameter": [{"name": "myParam", "value": "TEST"}]}' https://jenkins.corp/job/$JENKINS_JOB/build

Damit json=...wird der Parameter myParammit dem Wert TESTbei jedem Aufruf an den Job übergeben. Der Jenkins-Job wird jedoch auch dann ausgeführt, wenn der Parameter nicht erwartet wird myParam.

Das einzige Szenario, das hier nicht behandelt wird, ist, wenn der Job einen Parameter hat, der NICHT in der übergeben wird json. Selbst wenn für den Parameter ein Standardwert festgelegt ist, kann der Job nicht ausgeführt werden. In diesem Szenario wird beim Aufruf die folgende Fehlermeldung / Stapelverfolgung angezeigt /build:

java.lang.IllegalArgumentException: No such parameter definition: myParam

Mir ist klar, dass diese Antwort einige Jahre zu spät ist, aber ich hoffe, dass dies nützliche Informationen für jemand anderen sind!

Hinweis: Ich verwende Jenkins v2.163

Um die Variablen zu übergeben / zu verwenden, erstellen Sie zuerst Parameter im Abschnitt configure von Jenkins. Die von Ihnen verwendeten Parameter können vom Typ Text, Zeichenfolge, Datei usw. sein.

Verwenden Sie nach dem Erstellen die Variablenreferenz in den gewünschten Feldern.

Zum Beispiel: Ich habe zwei Variablen für Email-subjectund konfiguriert / erstellt und Email-recipentListderen Referenz im EMail-extPlugin verwendet (angehängter Screenshot).

Sie können es einfach mit einer Jenkins-Datei versuchen. Erstellen Sie einen Jenkins-Job mit dem folgenden Pipeline-Skript.

pipeline {
    agent any

    parameters {
        booleanParam(defaultValue: true, description: '', name: 'userFlag')
    }

    stages {
        stage('Trigger') {
            steps {
                script {
                    println("triggering the pipeline from a rest call...")
                }
            }
        }
        stage("foo") {
            steps {
                echo "flag: ${params.userFlag}"
            }
        }

    }
}

Erstellen Sie den Job einmal manuell, um ihn zu konfigurieren, und erstellen Sie einfach eine http-POST-Anforderung für den Jenkins-Job wie folgt.

Das Format ist http://server/job/myjob/buildWithParameters?PARAMETER=Value

curl http://admin:test123@localhost:30637/job/apd-test/buildWithParameters?userFlag=false --request POST

Mithilfe der folgenden Abfrage können Sie Jenkins-Builds remote auslösen und Parameter übergeben.

JENKINS_URL/job/job-name/buildWithParameters?token=TOKEN_NAME&param_name1=value&param_name1=value

JENKINS_URL (kann sein) = https://<your domain name or server address>

TOKE_NAME kann über die Registerkarte "Konfigurieren" erstellt werden