Atlassian Bitbucket Connector

Index repositories, projects, pull requests, commits, and comments in Bitbucket.

The Atlassian Bitbucket connector indexes repositories, projects, pull requests, commits, and comments across your Bitbucket instance.

The connector supports Atlassian Bitbucket Cloud.

Installing the Bitbucket App Descriptor

In order to target your specific Atolio deployment, the Atlassian Bitbucket connector requires a private listing to be installed instead of the Atlassian marketplace version. This can be disabled again after the connect app is installed.

In your Bitbucket instance:

Under Settings -> Workplace settings, navigate to Installed apps under the APPS AND FEATURES section.
After clicking Enable development mode, click the link for Install app from URL.

Specify the URL provided by your Deployment Engineer. It will be similar to the following with your chosen DNS name:

https://relay.search.example.com/connectors/bitbucketcloud/default/install/atlassian-connect.json
Note: if you have multiple Bitbucket instances, please make sure to provide the correct instance name in the URL above (i.e. default in the example).

Once the Atolio Connect app has been installed, the configuration will be stored securely in your Atolio deployment. You can now disable the development mode as needed.

Required Configuration Values

Enter these values in the Atolio Admin console (v4.24 and later), or send them to Atolio Support (your Deployment Engineer).

Value	Where to find it	Example / format	Secret
Workspace slug (`workspace`)	Your Bitbucket workspace ID, as it appears in `https://bitbucket.org/{WORKSPACE}`	`example`	No

Provided by Atolio: the app descriptor install URL (https://relay.search.example.com/connectors/bitbucketcloud/default/install/atlassian-connect.json), used for installing the Atolio app from URL in step 3.

Configuration Example

Add this block to connector-values.yaml. Replace each <PLACEHOLDER> with the matching value from the table above, and remove any line marked “Only if” that doesn’t apply.

connectors:
  bitbucket:
    default:
      bitbucket:
        connector: bitbucket
        instance: default
        source: bitbucket
        common:
          enabled: true
          identity-provider: false
        secrets: {}
        configuration:
          workspace: "<WORKSPACE_SLUG>"