You are here:
Set Up DevOps Center for Bitbucket (Beta)
Set up DevOps Center to use a Bitbucket source control repository. Currently, we support only Bitbucket Cloud.
A repository stores project work files — code, text, images, and so on. Each DevOps Center project needs its own repository for storing project changes. While you’re working on the project, the repository is the team’s centralized source of truth to manage changes.
If you’re familiar with using DevOps Center with GitHub, some of the steps are different for setting up Bitbucket. As part of our extensibility initiatives, we’re transforming our user interface, where DevOps Center functionality is moving to Lightning Experience so you have more control and flexibility in customizing the user experience. During this transition period, some Bitbucket setup and configuration tasks are performed in Lightning Experience and some are performed in the DevOps Center app. Menu options and buttons help you smoothly transition between the two.
Bitbucket Workflow
- Create a Bitbucket Cloud account. All team members must have their own Bitbucket Cloud account.
- If your organization doesn’t already use Bitbucket, follow the Bitbucket documentation to set up:
- A workspace
- A project
- At least one repository
Bitbucket Repository Configuration
If you have an existing Bitbucket repo, you can use it as long as it follows the Salesforce DX project structure. If it isn’t a Salesforce DX repo, you can add the necessary DX project file.
- In Bitbucket, add team members to the repo as collaborators.
- In Lightning Experience, connect the repository in DevOps Center.
- In Lightning Experience, create the DevOps Center project.
- Complete any optional configuration tasks.
- In the DevOps Center app, add your project environments, build your pipeline, and create and assign work items. All user tasks are performed in the DevOps Center app.
- Add Salesforce DX Project File to Bitbucket Repository
To support DevOps Center features, the Bitbucket repository must follow the Salesforce DX project structure and contain a Salesforce DX project file. - Add Team Members to the Bitbucket Repo As Collaborators
In Bitbucket, add team members as repository collaborators. A collaborator is someone who has been granted write access to the project repository. Add everyone who creates customizations or code for your project to the project repository as a collaborator. That way, they have access to the repository through DevOps Center. - Connect the Bitbucket Repo in DevOps Center
Each DevOps Center project has a corresponding project repository. By connecting the Bitbucket repo to DevOps Center, DevOps Center can interact with the repo to perform operations such as creating feature branches, creating change requests, and committing and merging changes to each pipeline branch (stage).
