How to remotely trigger Jenkins multibranch pipeli

问题:

Title mostly says it. How can you trigger a Jenkins multibranch pipeline project build from a remote git repository?

The "Trigger builds remotely" build trigger option does not seem to work, since no tokens that you set are saved.

回答1:

At the moment (Jenkins 2.22) the "Trigger builds remotely" build trigger option is visible in the multibranch pipeline job configuration, but does not work (if you check it and specify a token, it gets reset after saving anyway). According to this, it is intentional that the trigger cannot be set, but a bug that it appears as an option at all.

In the same thread they explain how to trigger builds for each individual project (branch) in a multibranch pipeline project. What I needed was a dynamic setup that would work for branches created after setting up the trigger, so rather than the suggested endpoint from the thread (/job/project-name/job-name/build, which should have been /job/job-name/project-name/build , since projects are created from branches in a job), I found that the endpoint to use is /job/job-name/build. In order for that to work you have to create a user with an API token (go to Manage Jenkins -> Manage Users -> Gear icon -> Show API Token), and use those as username and password in your request.

The solution might be obvious for those used to working with Jenkins REST API, but when you are new to both multibranch pipeline projects and the REST API, it doesn't hurt to be explicit.

回答2:

I couldn't get the API token as described in the accepted answer because there is no such link called "Manage Users" even though I log in as admin. Instead, I got the token as described in the Jenkins Wiki:

The API token is available in your personal configuration page. Click your name on the top right corner on every page, then click "Configure" to see your API token

Once you have the token, the following curl request will trigger a new build for a multibranch pipeline (Replace placeholders starting with $)

curl -X POST -u "$jenkins_username:$api_token" "http://$jenkins_url/job/$my-pipeline/job/$branch_name/build?token=BUILD_TOKEN"

Notes:

1. If the pipeline or branch name contains special characters, you need to encode it; for example, / becomes %252F.
2. The token query parameter is optional.
3. This answer has been verified in Jenkins v2.6.

回答3:

I just recently got over this hurdle and would like to share my note.

In my configuration (Jenkins 2.60.2), there is no way for me to enable the Trigger builds remotely (e.g., from scripts) option since I can only "View Configuration". This prevented me from trigger the pipeline by issue HTTP GET to end point (/job/project-name/job/job-name/build).

However, I found out that I can always trigger by issue HTTP POST to the end point.

You will have to provide a valid crumb in the request or disable the "Prevent Cross Site Request Forgery exploits" option in Configure Global Security.

Regards,

回答4:

Without disabling the Cross Site Request Forgery (CSRF) protection, the commands you can make use of are

crumb=$(curl -s 'http://USERNAME:API_TOKEN@JENKINS_URL/crumbIssuer/api/xml?xpath=concat(//crumbRequestField,":",//crumb)')
curl -X POST -H "$crumb" "http://USERNAME:API_TOKEN@JENKINS_URL/job/JOB_NAME/build"

Replace the capital letters with the appropriate values.