GitLab Website

How to Integrate Testuff with GitLab

Testuff can automatically send every reported defect to your GitLab account, allowing you to continue using GitLab for bug tracking while running your manual tests in Testuff.

Configuring Testuff for GitLab

Follow these steps to set up the integration between Testuff and GitLab:

  1. Access Bug Tracker Settings:
    • Go to Settings in Testuff.
    • Select Bug Trackers.
    • Click on the Add Bug Tracker link.
  2. Select GitLab:
    • From the bug tracker dropdown, choose GitLab.
    • Enter the GitLab URL:
      • For cloud-hosted GitLab, use https://gitlab.com/api/v4.
      • For a locally hosted GitLab, use the URL for your GitLab server (e.g., https://my-gitlab-server.com/api/v4).
    • Set the Default Project. Any defects exported from Testuff projects without a custom GitLab project will use this default project.
  3. Set User Token: Click Set User to enter your GitLab token.
  4. Test Connection:
    • Click the Test connection link to verify the setup.
    • Optionally, click Submit sample to ensure Testuff can create bug reports in GitLab. A new bug report should appear if the setup is successful.
    • Don’t forget to click OK to save the settings.

Creating Your GitLab Token

To create a personal access token in GitLab:

  1. Access Token Settings:
    • On any GitLab page, click your profile icon and select Settings.
    • In the sidebar, click Access Tokens.
  2. Generate a Token:
    • Provide a description for the token and check the “api” scope.
    • Click Create personal access token to generate the token.

Setting Up Automatic 2-Way Integration

Testuff offers a unique feature that automatically updates reported defects in Testuff with any changes made in GitLab. To enable this:

  1. Set Up Webhooks in GitLab:
    • In GitLab, go to the repository you own.
    • Click Settings and select Webhooks from the left-side menu.
    • Add a new webhook:
      • Under URL, enter the URL provided in Testuff under Settings > Bug Trackers > GitLab (found under “Automatic 2-Way Integration URL”).
      • Check Issues events.
  2. Complete Webhook Setup: Click Add webhook to finalize the integration.

Associating a Custom GitLab Project with a Testuff Project

You can configure specific Testuff projects to export defects to specific GitLab projects:

  1. Select a Testuff Project:
    • Go to Settings and click on Projects.
    • Select a project by clicking Edit next to it.
  2. Set the Bug Tracker:
    • Under the General Settings section, ensure the Tracker field is set to GitLab.
    • Enter the project details for this Testuff project.
  3. Save Your Settings: Click SAVE to register the new settings.

 

Please contact our support team for further assistance with integrating Testuff and GitLab.