How do I get Jenkins to build on push to a BitBucket git repository?

We know that for many of our customers Jenkins is incredibly important and its integration with Bitbucket Server is a key part of their development workflow. Unfortunately, we also know that integrating Bitbucket Server with Jenkins wasn’t always easy – it may have required multiple plugins and considerable time. We began building our own integration, and we’re proud to announce that v1.0 is out.

DevOps plays a very important role in application development. Whenever your git repo observes any change an automatic build will get triggered in Jenkins. By default push trigger is activated and if you want to activate other action, please select those events while creating webhook. In our current environment Jenkins gets a push request to preform some actions and starts a job. One of those actions in this job is to trigger the Maven release plugin. Maven creates a new version and afterwards does a commit to Bitbucket where all pom.xml files are edited with the increased (snapshot) version.


This setting is necessary for the webhook callback to trigger the build on this project. In this final part of our journey, we are going to finally implement the CI / CD pipeline using a Jenkinsfile. As it was mentioned in the first part of the tutorial, this pipeline will consist of several parts which will be triggered once a push on the bitbucket repo is made. We will also setup the webhook to let bitbucket inform Jenkins to start a new build on each push.

jenkins bitbucket integration

Then click the Create repository button to create a repo. Push code to Jenkins when new code is committed using BitBucket webhooks. Example of pipeline code for building on pull-request and push events. To find out how to install and configure this integration, and how to create your first pipeline, watch this video. They have a workaround, but it’s a nasty one; abort the Jenkins job if commit is from Jenkins (the commit above).

Adding Bitbucket Server instance details to Jenkins

If buildKey and buildName parameters are not provided, a standard name
will be assigned to the build (NameOfYourJob #numberOfBuild – eg.
MyProject #32). Once you have configured the credential, you can notify BitBucket from
your Pipeline script through the bitbucketStatusNotify step. Every time you trigger a build, you don’t have to log in to your build
server to see if it passed or failed.

jenkins bitbucket integration

We are going to create the S3 buckets, the ECR repositories and complete the definition of the IAM roles by adding the correct policies. Part 1 (here)→ Set up the project by downloading and looking at the Web App which will be used to test our infrastructure and pipeline. Here we also create & test suitable Dockerfiles for our project and upload everything to Bitbucket. This is the plugin (Stash webhooks for Jenkins which is not called Bitbucket webhooks for Jenkins) which can be downloaded from Atlassian Marketplace. For anyone here after July 2022, here are the simple steps I followed to make it work. Whenever a pipeline you run is completed, Actioner notifies you with a direct message.


Make sure to include the slash (‘/’) on the end of the URL or the hook won’t work. 1) Go to your bitbucket repo, click on Repository Setting, under WORKFLOW got for WEBHOOKS option and create a webhook. Add create your super simple pipeline that builds the branch or just print the hello world message. Do not forget to check “Build when a change is pushed to Bitbucket” in your job configuration.

  • For anyone here after July 2022, here are the simple steps I followed to make it work.
  • Also, from beta 1, you don’t have to manually add webhooks to bitbucket server.
  • I had this problem and it turned out the issue was that I had named my repository with CamelCase.
  • This plugin aims at the Atlassian-hosted BitBucket Cloud solution, not
    BitBucket Server (formerly known as Stash).
  • Integrated CI/CD enables you to create a link between Bitbucket Data Center and Server and Jenkins, unlocking a range of benefits.

Now you will be able to know when
your build is passing right within the Bitbucket UI. We can always click on the Artifacts button on the top right to see the pipeline.log text file with the details of all the commands run in the pipeline. At the end we check whether there was actually an error and eventually we terminate the Pipeline with error(“Failed unit tests”) . Part 4 (here)→ Create the second part of the AWS Infrastructure with Terraform.


Looks like a very good possibility to work with the CI/CD capablities of Jenkins (pipeline as code). Less overhead in the current setup, a plugin in Bitbucket and Jenkins. Really excited about this and happy that Atlassian dove in head first rather than the normal model of leave it up to the marketplace. Secondly, create a Jenkins Pipeline that checks out and builds the code. In Webhook to Jenkins for Bitbucket is it possible to define users from which commits should be ignored (the version we use (the free one), this is bugged). The bitbucketStatusNotify step notifies the status of a build identified
by a build key and build name to BitBucket (see all options under API).

As a plugin developer you can use this plugin as dependency of your plugin by adding a dependency tag to your POM. Generate an authentication token and make sure you don’t share it. Anyway, you can check access.log and see if Bitbucket makes a try or not.

bbs_deploy: Wrapper step to notify Bitbucket Server of the deployment status.

Also, from beta 1, you don’t have to manually add webhooks to bitbucket server. The plugin does that for you provided the “Bitbucket Server trigger build after push” checkbox is enabled. It exposes a single URI endpoint that you can add as a WebHook within each Bitbucket project you wish to integrate with. This single endpoint receives a full data payload from Bitbucket upon push (see their documentation), triggering compatible jobs to build based on changed repository/branch. Hopeful we can remove all the build/webhook plugins from our instances and reduce the overhead.

Creating an Application Link to Jenkins enables additional functionality in Bitbucket Server. Watch our video to find out how to do this, or see below for written instructions.

Create a live Jenkins URL

This will make it easier for them to select the repo to be cloned. This application is still work in progress and not considered production ready. I would jenkins bitbucket integration recommend trying it out on smaller projects for now and please provide you feedback about what features you would like to seen in the future versions.

Leave a Comment

Your email address will not be published. Required fields are marked *

Shopping Cart