GitLab Integration

The Cypress Dashboard can integrate your Cypress tests with your GitLab workflow via commit statuses and merge request comments. A project first needs to be setup to record to the Cypress Dashboard to use GitLab integration.

Installing the GitLab integration

  1. Visit Integrations → GitLab in the Cypress Dashboard.
  2. Follow the instructions to create a new OAuth2 application in GitLab. See the GitLab docs for more details.
  3. Copy the Application ID and Secret back to the Cypress Dashboard.
  4. Connect your projects to a GitLab repo.
  5. (Optional) Configure the behavior for each project.

Configuring the GitLab integration

Commit statuses

By default, Cypress will post a cypress/run commit status containing the results of the Cypress run. This will prevent your team from merging any MRs with failing Cypress tests.

Additionally, Cypress can post a cypress/flake commit status indicating whether the Cypress run contained any flaky tests. This will prevent your team from merging any MRs with flaky tests.

You can manage this behavior in your project's Project Settings page.

Merge Request comments

By default, Cypress will post a MR comment summarizing the run when the run completes. It will include test counts, run info, and a summary of tests that failed or were flaky.

You can manage this behavior in your project's Project Settings page.

Uninstalling the GitLab integration

You can remove this integration by visiting the Integrations → GitLab page of your organization. This will stop all commit checks and MR comments from Cypress.

Feedback

Have ideas for how we can improve our GitLab Integration? Let us know!