integrating bitbucket and jenkins

May 21, 2014 2 min read devops jenkins

I just had a little gotcha using Jenkins and trying to integrate it so that bitbucket can use git hooks to kick off builds on commits. So I thought I’d share how I managed to get it all working as to me it wasn’t that clear.

Firstly I’ll assume you have a secured Jenkins instance setup and a repository on bitbucket.

Once it’s working login to your jenkins instance as the user you wish to use to kick off builds and manually build a job you’ve configured. I’d suggest creating a user for functions like this. Lets call him ‘dodwmd_jenkins’

You then need to grab the ‘API token’ for this user. To do that, from the Jenkins home page, click on People, click on the desired user, click configure on the left, then, finally, click on the API Token button. Lets say it’s ‘ji0foi6jeseGhi4f’

Now in another browser tab open bitbucket and browse to your repository. Click settings and select ‘Hooks’. From the dropdown, select ‘Jenkins’, click ‘Add Hook’, then click on the edit link next to the newly created hook and fill in the form:

endpoint	The endpoint needs to be the publicly accessible URL to your jenkinsinstance. But it needs to include the username we used before and the 'API token' in our other tab. So an example would be http://dodwmd_jenkins:[email protected]/
module name	leave this blank
project name	Set this to be the name of the job you setup in jenkins. Don't worry about encoding the name bitbucket will do this for us.
token	set this to be the token you setup in your job when you ticked the 'Trigger builds remotely (e.g., from scripts)' box

Click save

Push a change to your bitbucket repo and you should see a build running on your jenkins install!

troubleshooting

You can check if your hook endpoint is working correctly:

$ curl -XPOST 'http://dodwmd_jenkins:[email protected]/job/buildstuff/build?token=thoucaephuHe2lai'

troubleshooting

further reading