Skip to content

Prerequisites for connecting a Bitbucket repository to the Data Productivity Cloud

Editions

This feature is for customers on our Enterprise edition only. Visit Matillion pricing to learn more about each edition.

Connecting a Bitbucket cloud repository to the Data Productivity Cloud is a straightforward process. Read on to learn what steps are required.

Note

These setup steps detail what is required to connect a Bitbucket cloud project to the Data Productivity Cloud. While it may be possible to connect using Bitbucket Data Center, this is not yet officially supported.


1. Create a new Bitbucket repository (optional)

Once signed in to your Bitbucket account, create a new project in your preferred workspace. We strongly recommend also initializing the repository with a README file. The repository for the project will be created with main as the default branch.

Note

A branch called main is required, but it does not have to be the default branch.

Want to use an existing repository?

If you already have an existing Bitbucket repository, you can connect it to your Data Productivity Cloud project, too.

Once you complete the authorization process between Bitbucket and Matillion, you will see any existing repositories in the workspaces that you have the permission to view the source code of.

Warning

For users with access to a large number (> 100) of repositories, this may take a short while to load. This is a known degradation, with improvements actively being worked on to mitigate the issue.

If you choose an existing repository to connect to the Data Productivity Cloud, then all existing branches will be visible in your branch list in the Branches tab.


2. Set up Bitbucket roles and permissions

There are numerous levels at which to control access of users to your Bitbucket repositories, whether that is on a specific repository, at a project level to control a collection of repositories, or across an entire workspace. These controls can be applied to an individual user, or to a "group" of users.

This is not intended to be a primer on Bitbucket access control; however, you can read more about granting Bitbucket repository access in the Atlassian documentation. Here you can also find an explanation for configuring Bitbucket project access, which differs slightly to individual repositories.

For a user to select a Bitbucket repository as a destination in the Data Productivity Cloud, they will need to be considered a Contributor, meaning they are able to write to a repository whether it is public or private. Consequently, repositories for which a user only has read-only access will not appear for selection in the Data Productivity Cloud.


3. Set up project access in Designer (optional)

If you wish to collaborate with other Data Productivity Cloud users on the same project, add them to your project by following the instructions at Access. Make sure these users are members of the same Bitbucket workspace that contains the Bitbucket repository you have connected to your Matillion project, and that they have write access to the repository through their user or group permissions.


Troubleshooting Bitbucket repository connections