Skip to main content

Bitbucket

CatalogGitOpsScorecards

Summary​

Bitbucket is a Git-based VCS from Atlassian. You can use Bitbucket to drive insights into values such as:

  • Repository details in the Catalog
  • Scorecard rules

The Bitbucket integration can also be used to power Cortex with GitOps.

Setup​

Cortex Cloud​

When using Cortex Cloud, you can use our official Bitbucket App, which can be found under Settings β†’ Bitbucket.

Cortex Server​

If self-hosting Cortex, you'll need to use basic auth to connect to Bitbucket. Add your Bitbucket host, username, and password under Settings β†’ Bitbucket by selecting On Prem in the dropdown.

We recommend setting up a bot account that has the desired access levels for the user.

caution
If you’re using a self-hosted instance of Bitbucket, you’ll need to verify that your Cortex instance is able to reach the Bitbucket instance. See our IP Whitelist section for more.

Service Registration​

Service Descriptor​

x-cortex-git:
bitbucket:
repository: <workspace>/<repo>

The value for repository should be the workspace/repo as defined in Bitbucket.

Troubleshooting​

  1. Rules are failing saying that I don't have file x, but it's definitely there!
    1. We always use the default branch for file existence checks. Make sure that the file is present in the default branch.