Skip to main content

GitLab

GitLab is a web-based DevOps lifecycle tool that provides a Git repository manager providing wiki, issue-tracking, and CI/CD pipeline features.

With Qase’s GitLab integration, you can:

  • Link your GitLab issues to Qase test cases, test runs, defects

  • Create a new issue in GitLab when you file a defect during a test run in Qase and their statuses are automatically synchronized, in both directions. [Qase <> GitLab]

  • Trigger your GitLab automated pipeline directly from Qase.

Installation

For installation, you will require GitLab URL and the Access token.

  1. Firstly, sign-in to your GitLab account and navigate to the Preferences from the profile menu:

    The GitLab profile menu with Preferences selected

  2. Go to the Access tokens page:

    The Access tokens page in GitLab user settings

  3. To create a new Personal Access Token, select the scope api and click on the Create Personal Access token:

    Creating a personal access token in GitLab with the api scope selected

  4. Copy your token to clipboard.

  5. On Qase, navigate to the Apps section, find the GitLab app and click Install now.

    The GitLab app card on the Qase Apps page, with its Install now button

Here, provide the Access token from the previous step, and URL of your GitLab instance (the field is pre-populated with the default value)

The GitLab installation form in Qase, with the access token and GitLab URL fields
  1. Click the Install button. After a few seconds, you will be redirected to the Apps page with a confirmation message as shown below.

    The Apps page confirming that the GitLab app has been installed

Please note, a Maintainer role is required if you choose to use a Group token.

Usage

Linking your Qase Test cases

In your repository, click any test case to open its preview and switch to the Properties tab.

Scroll down to the “Link with Apps” section, and choose the GitLab app. Then, proceed to search and link your issues.

Linked issues can be removed with the ( x ) icon.

Linking a GitLab issue from Link with Apps on the Properties tab of a test case

Linking your Qase Test runs

Test runs can be linked to a GitLab issue, from the Run Dashboard.

Under the “External Issues” section, click 'Select an Integration' to proceed. Only one GitLab issue can be linked to the Test run.

Linking a GitLab issue to a test run from External Issues on the run dashboard

Linking your Qase Defects

Defects can be linked to a GitLab issue, from the Defect Dashboard.

Under the “External Issues” section, select the GitLab app to proceed.

Linking a GitLab issue to a defect from External Issues on the defect dashboard

Create a GitLab issue from a Qase Test Run

When you assign a negative result to a case during a test run, you will have the option to create or attach a Qase defect.

Additionally, you can select the ‘GitLab’ app from the “Choose Integration” dropdown to either create a new GitLab issue, or link an existing one.

The created or linked issue will be visible in both the defects tab of the test run and the defect section of the project.

Creating a new GitLab issue from a negative result during a test run
  • You can view the link to the GitLab issue in

    • Defects tag of the test run

      The link to the GitLab issue shown in the defects tab of the test run

    • From the Qase defect screen

      The link to the GitLab issue shown on the Qase defect screen

CI/CD Workflows

Please note, that you will need to configure a Qase API reporter in your project for the results of your automated tests to be published to the Qase Test run.

  1. Create the Automated Test Run:

    Creating an automated test run in Qase

  2. Select the Gitlab option in the CI/CD System field:

    The CI/CD System field of the run form set to Gitlab

  3. Fill in all necessary fields and click the Start a run button:

    The filled-in automated run form, with the Start a run button

Did this answer your question?