Setting up Bitbucket Server integration for your project

How to set up Bibucker Server or Data Center integration features for your SonarQube Server project.

Reporting your quality gate status to Bitbucket Server or Data Center for unbound projects

On SonarQube Server projects bound to their Bitbucket repository, SonarQube Server automatically sets up the report of your quality gate status and analysis metrics directly to your pull requests. For unbound projects, you must set up the quality gate status report manually. The integration of your SonarQube Server instance with Bitbucket Server or Data Center must be properly set up.

To report your quality gate status in Bitbucket for unbound projects:

1. In the SonarQube Server UI page of your project, select Project Settings > General Settings > DevOps Platform Integration.

2. Set:

   • Configuration name: The configuration name that corresponds to your DevOps Platform instance.

   • Project Key: the project key is part of your BitBucket Server repository URL (.../projects/<key>/repos/<slug>/browse).

   • Repository SLUG: The repository slug is part of your BitBucket Server / Data Center repository URL (.../projects/<key>/repos/<slug>/browse).

Preventing pull request merges when the quality gate fails

After setting up pull request analysis, you can block pull requests from being merged if it is failing the quality gate. To do this:

1. In Bitbucket Server or Data Center, navigate to Repository settings > Code Insights.

2. Add a Required report called com.sonarsource.sonarqube

3. Select Must pass as the Required status.

4. Select Must not have any annotations as the Annotation requirements.

Preventing pull request merges when the quality gate fails is not supported for monorepos.

Related pages

Setting up Bitbucket Server integration at global level Importing your Bitbucket Server repositories