Configuring GitLab project binding

Setting up GitLab integration features for your project in SonarQube Cloud.

Once your GitLab group has been imported to SonarQube Cloud, you can create your SonarQube Cloud project by importing your GitLab repository. The created SonarQube Cloud project is bound to its GitLab repository. To bind an unbound project, see Binding an unbound project to a repository.

Setting up pull request integration

For a bound project, the quality gate status and analysis metrics are reported to your pull requests in GitLab provided:

• Your build script is configured to build on pull request creation and push.

• If you don't use an integrated CI tool, you must set up the pull request parameters manually, see Analysis parameters for more details.

• See Prerequisites for CI-based analysis for additional information.

Preventing the pull request merge if the quality gate fails

In GitLab, you can block merge requests if it is failing the quality gate. To do this:

1. In your GitLab repository, go to Your project > Settings > Merge requests.

2. In the Merge Checks section, select Pipelines must succeed. More information about GitLab’s External status checks can be found in the GitLab Documentation.

3. Set up the pipeline to fail. It depends on your CI tool:

   • GitLab CI: see Failing the pipeline job when the SonarQube Cloud Quality Gate fails

   • GitHub Actions: see Failing the workflow when the quality gate fails

   • Bitbucket Pipelines: see Failing the pipeline job when the quality gate fails

The blocking of pull requests on quality gate failure is not supported for projects on a monorepo.

Related pages

• Getting started with GitLab

• Importing GitLab group

• Creating your project

• GitLab CI

• Setting your project's permissions

• Changing project binding

• Customizing Information page

• Deleting project