Bitbucket Integration

The Cypress Dashboard can integrate your Cypress tests with your Bitbucket workflow via status checks and pull request comments. A project first needs to be setup to record to the Cypress Dashboard to use Bitbucket integration.

Installing the Bitbucket integration

  1. Visit Integrations in the Cypress Dashboard.
  2. Click Install Bitbucket Integration.
  3. (For beta only) You need to enable Bitbucket's development mode for your user account to continue.
  4. Continue through the Bitbucket OAuth installation flow in the popup window.
  5. Once installed, connect your projects to a Bitbucket repo.
  6. (Optional) Configure the behavior for each project.

Configuring the Bitbucket integration

Status checks

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 PRs 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 PRs with flaky tests.

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

Pull Request comments

By default, Cypress will post a PR 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 Bitbucket integration

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

Feedback

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