Skip to content
The docs are now organized by product area. Old links still work. Report a broken link

GitLab Integration

Connect Qualflare to GitLab.com to file GitLab issues automatically for new defects, failed test runs, failure clusters and flaky tests.

Last updated

The GitLab integration files GitLab issues from Qualflare. When an event you selected happens in a project, such as a new defect, Qualflare creates an issue in the GitLab project you chose. It works one way: nothing you do in GitLab changes Qualflare.

It works with GitLab.com only. Self-managed GitLab instances can't be connected.

Setup

Step 1: Install the GitLab Integration

  1. In the workspace sidebar, open Integrations. You need a workspace role of Editor or higher
  2. Find GitLab under CI/CD
  3. Click Install
  4. Sign in to GitLab.com and authorize Qualflare. It asks for the api scope
  5. The integration is installed at the workspace level

Step 2: Connect a GitLab Project

  1. In the project sidebar, open Integrations. You need the Editor role or higher on the project
  2. Click Configure on the GitLab integration
  3. Select the Project. Optionally add Labels
  4. Under Events, select the events that should create an issue
  5. Click Save

What the Issue Contains

For a defect, the issue title is [Defect #12] <defect name>. The body lists the defect's severity, environment, category, status, team and root causes when they are set, then the description and the expected and actual results. It ends with Created automatically by Qualflare. Your Labels are applied.

The issue has no link back to Qualflare. Instead, the defect shows the new issue under Linked issues.

Events

Qualflare EventGitLab Issue Title
Defect Created[Defect #12] <defect name>
Launch Failed[Launch #48] Failed — <status>
Cluster Created[Cluster] <cluster name>
Flaky Test Detected[Flaky] <test case name>

Launch Failed fires when results uploaded with the CLI, a reporter or the API include a failed, error, timed-out or aborted test. Qualflare only creates issues. It does not close, reopen, update or comment on them.

Disconnecting

Removing GitLab deletes every project's GitLab settings. If the card shows Reconnect, GitLab no longer accepts Qualflare's access, and the only fix is to remove the integration, install it again and set up each project from scratch.

To remove the GitLab integration, open Integrations in the workspace sidebar, click the trash icon on the GitLab card, then click Remove.

See Also