Bitbucket-Jenkins-Connector

Web service to integrate Bitbucket webhooks with Jenkins multi-branch projects.

Execute a Jenkins branch task based on the pushed branch from Bitbucket.

Prerequisites

• Pipeline Multibranch Plugin for Jenkins. Use the Jenkins plugin update center to download and install the latest version:

  Pipeline Multibranch Plugin

  The project types will appear in the list on the "New Job" page. When configuring the project, the SCM portion will be different. This section tells the project how to find branches to create sub-projects for. Just about everything else should look like a normal free-style project and will be applied to each sub-project.

Configuration

1. Clone the project in the path you want:

   $ git clone https://github.com/rubenmromero/bitbucket-jenkins-connector.git
   

2. Create a copy of jenkins.yaml.dist template as conf/jenkins.yaml, edit the new file and set the Jenkins global parameters replacing the existing <tags> by the appropriate values:

   # From the project root folder
   $ cp -p conf/jenkins.yaml.dist conf/jenkins.yaml
   $ vi conf/jenkins.yaml
   

3. For Debian OS family, enable Apache cgi module (in Red Hat OS family this module is loaded by default):

   $ sudo a2enmod cgi
   

4. Enable bjconnector VHost:

   • For Debian OS family:

     # From the project root folder
     $ sudo cp vhost/bitbucket_access.conf /etc/apache2/
     $ sudo cp vhost/debian/bjconnector.conf /etc/apache2/sites-available/
     $ sudo vi /etc/apache2/sites-available/bjconnector.conf
     # Replace the existing <tags> with the appropriate values
     $ sudo a2ensite bjconnector.conf
     $ /etc/init.d/apache2 restart
     

   • For Red Hat OS family:

     # From the project root folder
     $ sudo cp vhost/bitbucket_access.conf /etc/httpd/conf/
     $ sudo cp vhost/redhat/bjconnector.conf /etc/httpd/conf.d/
     $ sudo vi /etc/httpd/conf.d/bjconnector.conf
     # Replace the existing <tags> with the appropriate values
     $ /etc/init.d/httpd restart
     

For each new project to deploy through Jenkins:

1. Create a copy of project.yaml.dist template as conf/<project>.yaml, edit the new file and set the Jenkins project parameters replacing the existing <tags> by the appropriate values:

   # From the project root folder
   $ cp -p conf/project.yaml.dist conf/<project>.yaml
   $ vi conf/<project>.yaml
   

2. Enable the "Trigger builds remotely (e.g., from scripts)" checkbox for each branch task of the multi-branch project, setting the same authentication token that has been entered in the task_token parameter of the conf/<project>.yaml file created before.

3. Configure the following webhook in the Bitbucket project:

   • Title => Jenkins-Deploy_<Project>
   • URL => http://bjconnector.<domain>/deploy_branch.py?project=<project>[&application=<submodule>]
   • Status => Active
   • Triggers => Repository push