Bitbucket Server integration

Atlassian Bitbucket Server integration lets you link Bitbucket Server projects to associated products so you can have visibility into all repositories and pull requests.

For supported Bitbucket Server versions, refer to the Supported platforms for CloudBees Engineering Efficiency.

After you install the plugin, you can establish a connection between the Bitbucket Server and your CloudBees Engineering Efficiency user profile.

Installing the CloudBees Software Delivery Management plugin on the Bitbucket Server

You must have Bitbucket Server administrative privileges to upload and install the CloudBees Engineering Efficiency plugin.

You must install the CloudBees Software Delivery Management plugin to establish a connection between the Bitbucket Server and your CloudBees Engineering Efficiency user profile. To install the plugin:

  1. Sign into your Bitbucket Server instance.

  2. Select the Settings icon on the top right.

  3. Select Manage apps on the left navigation.

  4. Enter your Bitbucket Server administrative privileges, if prompted.

  5. On the sidebar menu on the left, select Manage apps.

  6. Select the Upload app link on the right.

  7. Enter this URL into the From this URL text box: https://github.com/cloudbees/sdm-bitbucket-plugin-release/releases/latest/download/sdm-bitbucket-plugin.obr

  8. Select Upload.

  9. If successful, the Installed and ready to go! window appears. Select Close.

Connecting your CloudBees Engineering Efficiency organization and the Bitbucket Server

Use the following sections to connect the Bitbucket Server to your CloudBees Engineering Efficiency organization. You can more than one Bitbucket installation per organization.

This is a two-step process:

  1. First, obtain a Refresh Token from CloudBees Engineering Efficiency.

  2. Use that token to configure the CloudBees Software Delivery Management plugin in your Bitbucket Server instance.

The steps are explained below.

This procedure requires CloudBees Engineering Efficiency administrator rights.

Obtaining a Refresh Token from the Bitbucket Server app

Sign into CloudBees Engineering Efficiency with administrative privileges to connect to the Bitbucket Server with the base URL:

  1. In the top right, select your organization to open the User profile menu and then select Organization settings.

  2. In the left navigation, select Engineering Efficiency Apps.

  3. Select Bitbucket.

  4. Select the Security Tokens tab.

    Figure 1. Refresh token tab
  5. Select Create refresh token and enter a memorable Token name.

  6. Copy the resulting Refresh Token that is created.

    You won’t see the token value again. However, you can delete it and add new ones.

Setting up the Bitbucket Plugin in your Bitbucket Server instance

Now that you have a refresh token, you can set up the Bitbucket Server plugin.

The CloudBees Software Delivery Management plugin must be installed before connecting your CloudBees Engineering Efficiency user profile.

Sign into your Bitbucket Server instance with administrative privileges:

  1. Sign into your Bitbucket Server instance as an admin.

  2. On the top right, select the Settings icon.

  3. Select Manage apps on the left navigation.

  4. In the list of User-installed apps, expand the entry for CloudBees Bitbucket Server Plugin.

  5. Select Configure.

  6. Enter the Refresh token that you obtained in the previous section into the Refresh Token field.

  7. Select Save.

  8. The plugin will now connect to CloudBees Engineering Efficiency and begin synchronizing data.

Removing the connection to a Bitbucket Server

If you no longer wish to use a Bitbucket Server connection, you can remove it. Remove the plugin from your Bitbucket Server. Sign into CloudBees Engineering Efficiency with administrative privileges to remove the connection to a Bitbucket Server:

  1. In the top right, select your organization to open the User profile menu and then select Orgnization settings.

  2. In the left navigation, select Engineering Efficiency Apps.

  3. Select Bitbucket.

  4. Select the Configuration tab.

  5. Choose the connection that you want to remove and select the vertical three dots on the right side.

  6. Select Remove. The Remove connection window opens.

  7. Select Remove. A window appears with a message that the Bitbucket Server was successfully removed.

Requesting data removal

Once data is imported into the System of Record, data will stay synchronized as part of normal operations as data changes. You can request to have data removed from your organization by contacting CloudBees support.