GitLab is a unique software that implements code repository, issue tracker, CI/CD, container registry, and many other cool features. It is used by a great number of teams all over the world.
Qase has built-in integration with GitLab that allows creating new issues every time you mark a test case in the run as failed and link it with the newly created defect. A new issue will contain the following information:
- Test case information: title and description
- Steps to reproduce
- A link to the run, where the defect was found
- Attachments (if they were added)
- A link to Qase defect
Qase is interacting with GitLab through API and requires a personal token for setup. There is an official guide on how to obtain this API token. Qase requires
api scope to call issue creation methods. All other scopes are unnecessary.
Step 1. Prepare
Each project in Qase has it's own integration settings, and you should have access rights to add/update integrations. You should open your project's settings, choose "Integrations" from the menu in the sidebar, and click on the "Install" button in GitLab's card.
Step 2. Connection
GitLab integration has an identical flow for both Cloud and Standalone installations.
On the current step, you will need to provide your GitLab host (https://gitlab.com for Cloud version) and Personal API token.
Step 3. Choose project
Each project in Qase is linked to a project in GitLab. If everything is right and we have successfully checked the GitLab connection, you will be redirected to the page with integration settings, where you should choose the GitLab project and issue type you want to use for new issues created from Qase.
Step 4. Defect creation
After you have GitLab integration installed and configured, you will be able to send issues from test runs. If you click on the failed button, you will see a modal window with a defect creation form. There will be a checkbox "Send defect to GitLab". If you keep it checked, Qase will create a task in the selected project.
Here is a list of most common problems you can face during integration setup or defect creation:
- GitLab installation is unreachable. This problem can appear if your GitLab is inside a private network and can't be accessed from the internet. To solve this problem, read the article: What are the Qase IP addresses I should use to configure my corporate firewall?
- User doesn't have access to the project. If the user loses access to the selected project, Qase won't be able to create new issues. To solve this problem, restore access to the project or create integration with a new API token from a user who has such access.
If you have any problems with GitLab integration, don't hesitate to contact us: firstname.lastname@example.org. We will help you to find a problem and solve it.