Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

Adding an instance of Jenkins in Bitbucket makes configuring project-level and repository-level easier by allowing Webhook to Jenkins to use the entered Jenkins instance location to set as the default URL.

While the instructions in this section are optional, we recommend this step as it makes subsequent setup and configuration steps simpler.

Global level

  1. Log into your Bitbucket instance as an Administrator.

  2. Click the Administration icon in the top right corner to open the Administration page.

  3. Under AddADD-onsONS, click Jenkins Servers.

    Image RemovedSide menu Jenkins ServersImage Added
  4. Click Add New Instance.

  5. Enter the Jenkins instance URL in the Jenkins Base field, your Jenkins Username and Password, and if you are using Git plugin version 4.11.4 or higher, the notifyCommit access token. See Access token requirements for Git plugin 4.11.4+ for information on how to generate the token. When using an earlier version of the Git plugin, the notifyCommit token is not required.

    Image Removedadd new jenkins instance dialogImage Added
  6. Click Save Instance.

You can also access this page through Bitbucket Administration (Administration > Manage Apps > Webhook to Jenkins for Bitbucket > Configure).

Project level

A new Jenkins instance can also be created at the Project level by Admins that have this level of access.

  1. Confirm you are logged into Bitbucket as an Administrator.

  2. Select the project you want to associate with Jenkins.

  3. Click Project Settings ⚙️ from the left sidebar.

  4. Click Webhook to Jenkins for Bitbucket under the ADD-ONS heading. The Webhook to Jenkins for Bitbucket page opens.

    webhook to jenkins page - project levelImage Added

To add a new Jenkins instance:

  1. Select the Scope (Global, Project) from the dropdown list.

  2. Click Add New Instance.

  3. Enter the Jenkins instance URL in the Jenkins Base field, your Jenkins Username and Password, and if you are using Git plugin version 4.11.4 or higher, the notifyCommit access token. See Access token requirements for Git plugin 4.11.4+ on how to generate the token. When using an earlier version of the Git plugin, the notifyCommit token is not required.

    new instance - project levelImage Added

Click Save instance. A successful entry appears in the Jenkins instance list.

From this page you can also:

  • View the current Hook status

  • Access Hook Settings (See Bitbucket Configuration for more information)

  • Access Documentation

  • Contact Support

Repository level

A new Jenkins instance can also be created at the Repository level by Administrators that have this level of access.

  1. Confirm you are logged into Bitbucket as an Administrator.

  2. Select the project you want to associate with Jenkins.

  3. Click Repository Settings ⚙️ from the left sidebar.

  4. Click Webhook to Jenkins for Bitbucket under the ADD-ONS heading. The Webhook to Jenkins for Bitbucket page opens.

    webhook to jenkins page - repository levelImage Added

To add a new Jenkins instance:

  1. Select the Scope (Global, Project) from the dropdown list.

  2. Click Add New Instance.

  3. Enter the Jenkins instance URL in the Jenkins Base field, your Jenkins Username and Password, and if you are using Git plugin version 4.11.4 or higher, the notifyCommit access token. See Access token requirements for Git plugin 4.11.4+ on how to generate the token. When using an earlier version of the Git plugin, the notifyCommit token is not required.

    new jenkins instance - repository levelImage Added
  4. Click Save instance. A successful entry appears in the Jenkins instance list.

From this page you can also:

  • View the current Hook status

  • Access Hook Settings (See Bitbucket Configuration for more information)

  • Access Documentation

  • Contact Support

When configuring Webhook to Jenkins at both the project and repository levels, the Jenkins instance URL is the default entry in the URL field.

...