How to connect gitlab with TestDirector
If you specifically need to integrate GITLAB mapping into TestDirector, follow these steps:
- Create a GITLAB account and find/create a project where you will perform testing and manage bugs/tasks
- Enter your GITLAB login to TestDirector: Projects >> Settings >> Ticketing system.
Follow these steps to set up your GITLAB integration:
- Issue tracker: GitLab (server)
- URL address: root GITLAB URL, e.g. https://GitLab.XXX.com
- Project (Key): fill in the name of your project in capitals based on the GITLAB project URL address
- User: your GITLAB username - these credentials are a default setting for connection to GITLAB project (e.g. username: Testing Squad 1), if you need a specific login for you as a tester, your GITLAB project will appear in My Profile settings (once you fill in your own GITLAB credentials there, every bug and task created in TestDirector will get created in GITLAB under your own GITLAB account name and not under the general name e.g. Testing Squad 1)
- Password: your GITLAB password
- Configure the GITLAB mapping in TestDirector Mapping section below the Connecting section - once you log in via your credentials, TestDirector will provide dropdown lists with options from your GITLAB project:
- Use diacritics: this allows you to synchronize TestDirector with GITLAB, using your bugs and tasks including diacritics within their names
- Range of synchronization:
- Full - there is no limitation, all bugs, tasks and sub-tasks will be synchronized to GITLAB
- Limited - restrict the synced items based on the label/tag which you enter in the field - the same label/tag name must be used in GITLAB.
To explain this further - all items in GITLAB having the specific label/tag, which was configured in TestDirector, will be synced with TestDirector.
On the other hand all items in TestDirector will be synced with GITLAB even if there is no label/tag in them.
- Issue Type - TestDirector will offer GITLAB name options in the dropdown lists - select the correct GITLAB name for a bug and a task
- Bug states - select the correct GITLAB names for bug status.
NOTE: The number of bug states must be equal to those configured in GITLAB project - configure your bug statuses in Project Settings >> Workflow >> Bugs - Statuses
- Task states - select the correct GITLAB names for task status.
NOTE: The number of task states must be equal to those configured in GITLAB project - configure your task statuses in Project Settings >> Workflow >> Tasks >> Statuses (button)
- Save your mapping.
- From now on, if you create a bug or a task in TestDirector, it will automatically get created in your GITLAB project as well.