For Webhook to Jenkins for Bitbucket Cloud to work correctly, you must perform some configuration steps in Jenkins. This section provides these configuration steps.
This section does not include detailed instructions regarding the initial setup of your Jenkins or Bitbucket instances. For more information regarding these topics, refer to Bitbucket and Jenkins documentation.
Before you begin
Before you begin configuring your Jenkins instance, confirm the following actions have been performed:
Install the Bitbucket Source Branch plugin and/or the Git plugin. Both plugins can exist on Jenkins simultaneously, but only one can be used as an endpoint for each repository. Refer to the What plugin should I use page for more information.
Install Webhook to Jenkins for Bitbucket Cloud.
Make sure your Jenkins instance is public-facing. A public-facing instance is required to successfully establish a connection between Jenkins and Bitbucket Cloud using Webhook to Jenkins for Bitbucket Cloud.
Configure Jenkins for use with Webhook to Jenkins
Log into your Jenkins instance.
Add or select the job you want to associate with your Bitbucket repository.
Once you are in the job, click Configure from the left menu.
Select the Source Code Management tab and the Git option when the Configuration page opens.
In the Repository URL field, enter the URL for the Bitbucket repository you want Jenkins to integrate with. This is the same URL as the one displayed in the Repo Clone URL field located in the Instance Details for your Jenkins instance of Webhook to Jenkins.
Click Add to open the Jenkins Credentials Provider dialog and click the Kind pull down to open the list of available options. Select the credential type you want to use and click Add. Go to SSH Credentials for Webhook to Jenkins for Bitbucket for instructions on how to set up SSH credentials.
Select the Build Trigger tab.
Select Poll SCM. This is an important step, as the build won’t trigger in Jenkins if this option is not selected.
Git plugin version 4.11.4 or higher requires the notifyCommit token. See Access token requirements for Git plugin 4.11.4+ for instructions regarding generating and using the token.
You are currently in Webhook to Jenkins for Bitbucket Cloud documentation. Click Server/Data Center to move to that document.