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 Qase test cases to GitLab issues

  • 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]

  • Link Qase test runs to GitLab issues

  • Execute automated runs in GitLab from a 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 from Qase to GitLab:

  1. To link a GitLab to a Qase test case from Qase:

  • Select a case in the repository and switch to Properties in the sidebar

  • Click “Link GitLab app issues”

  • Insert GitLab issue title into the field and hit “Link”

  • Now the issue is linked:

    Linking a GitLab issue from the Properties sidebar of a Qase test case

  • To unlink the GitLab issue, click “x” next to the card title:

    The linked GitLab issue on a test case, with the cross beside the card title that unlinks it

  • Link Qase Test Runs to GitLab issues:

  • Navigate to the Test Runs page

  • Click on the Run

  • In the Run's main page, locate the sidebar to the right

  • Scroll down and under “External Issue” click on “Select an Integration”

  • Select “GitLab app”

  • Search for the issue's title and click on “Link”

    Linking a GitLab issue to a test run from External Issue on the run's sidebar

Create a GitLab issue from a Qase Test Run

  • In the test run, mark your case as Failed, Blocked, or Invalid and proceed with creating a Defect.

  • in the Defect creation form, under “Choose Integrations” select “GitLab App” and click “Add defect”

  • Fill in the required fields, then hit “Create”

    Creating a GitLab issue while adding a defect from a failed result in 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

  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?