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
- In the workspace sidebar, open Integrations. You need a workspace role of Editor or higher
- Find GitLab under CI/CD
- Click Install
- Sign in to GitLab.com and authorize Qualflare. It asks for the
apiscope - The integration is installed at the workspace level
Step 2: Connect a GitLab Project
- In the project sidebar, open Integrations. You need the Editor role or higher on the project
- Click Configure on the GitLab integration
- Select the Project. Optionally add Labels
- Under Events, select the events that should create an issue
- 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 Event | GitLab 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
GitHub Integration
Connect Qualflare to GitHub to file GitHub issues automatically for new defects, failed test runs, failure clusters and flaky tests.
Jira Integration
Connect Jira Cloud with the Qualflare app for Jira and a pairing code, then file Jira issues automatically from Qualflare defects and test failures.