Bitbucket Integration

Integrate with BitBucket to perform checks against your repositories and build your catalog through config-as-code or service detection

Add a Bitbucket integration in OpsLevel

Integrating with OpsLevel's Bitbucket App does not require any direct setup within Bitbucket. However, it's advisable to setup a service account in Bitbucket to use as the OAuth user when integrating. To get started, follow these steps:

  • In the OpsLevel app, click Integrations in the left sidebar.
  • Click on the +New Integration button.
  • Click the Bitbucket integration card.
  • In the modal, click Integrate with Bitbucket
  • You will be redirected to Bitbucket to complete the authorization. Ensure the account you are signed into has the correct permissions, choose the correct workspace, and click Grant Access:
  • Done! We will pull in all repositories and begin synchronizing anyopslevel.yml files that we find.

Permissions

Here are the OAuth scopes defined by Bitbucket. The OpsLevel Bitbucket App requires the following scopes:

PermissionOpsLevel Usage
Read access to Account InformationView Users and Projects
Read access to RepositoriesFor running repo checks, syncing docs & more
Administer your repositoriesService Templates: creation of templated repositories
Read your team membership informationView teams
Read and modify repositories' webhooksTo notify OpsLevel of changes in the Repository, and keep information fresh

Did this page help you?