Интеграция с таск-трекером в GitLab

В этой статье описывается, как настроить интеграцию с системой задач GitLab, чтобы иметь возможность добавлять ссылки на задачи в ваши тест-кейсы и запуски в ТестОпс. Если вам нужно настроить интеграцию с GitLab CI для запуска тестов и получения результатов тестирования, см. эту статью.

Если вы уже настроили интеграцию с GitLab CI для вашего сервера GitLab, единственное, что вам нужно сделать, чтобы иметь возможность связывать задачи GitLab, это добавить идентификаторы проектов GitLab в вашу текущую интеграцию (см. Включение интеграции для проекта ТестОпс).

Чтобы настроить интеграцию с GitLab Issues, вам нужно:

1. Сгенерировать токен доступа в настройках GitLab.
2. Добавить интеграцию GitLab в панели администрирования ТестОпс.
3. Включить интеграцию в настройках проекта ТестОпс, используя сгенерированный токен доступа.

Генерация токена доступа GitLab

1. В GitLab нажмите на свой аватар и выберите Preferences.

2. В меню слева нажмите Access Tokens.

3. Нажмите Add new token на правой стороне страницы.

4. Заполните поля:

   • Token name — имя, которое поможет вам распознать токен (например, "Token for ТестОпс").
   • Expiration date — любая дата в пределах года с текущей даты. После этой даты интеграция перестанет работать, и вам нужно будет создать новый токен для продолжения использования интеграции.

5. Отметьте галочки api и read_api в разделе Select scopes.

6. Нажмите Create personal access token.

7. После перезагрузки страницы нажмите на иконку копирования под Your new personal access token. Сохраните токен в безопасном месте, он понадобится позже.

Вы также можете использовать токен доступа проекта вместо личного токена доступа, но в этом случае интеграция будет ограничена одним проектом.

Добавление интеграции GitLab в ТестОпс

1. Войдите в ТестОпс, используя учетную запись администратора.

2. Нажмите на свой аватар и перейдите в Administration → Integrations.

3. Нажмите Add integration в правом верхнем углу страницы.

4. В появившемся окне выберите GitLab.

5. Заполните поля:

   • Name — имя, которое поможет вам распознать эту интеграцию позже.
   • Endpoint — URL вашего сервера GitLab (например, https://gitlab.example.com/).

6. Если ваш сервер GitLab использует самоподписанный SSL-сертификат, отметьте галочку Disable certificate validation.

7. Нажмите Add integration.

Включение интеграции для проекта ТестОпс

1. Перейдите в настройки проекта.

2. Выберите Integrations.

3. Найдите интеграцию GitLab и нажмите Add integration.

4. В разделе Settings добавьте идентификаторы проектов GitLab, которые вы хотите использовать.

   Чтобы найти ID проекта, откройте проект в GitLab и перейдите в Settings → General

5. В разделе Secret введите ранее сгенерированный токен доступа GitLab.

6. Нажмите Add integration.

Добавление ссылок на задачи

После настройки интеграции с GitLab Issues вы можете добавлять ссылки на задачи в ваши тест-кейсы и запуски.

Чтобы связать тест-кейс с задачей GitLab:

1. Перейдите в Test cases.
2. Выберите тест-кейс, который хотите связать, и нажмите на иконку карандаша справа от страницы, рядом с Issues links.
3. В появившемся окне нажмите кнопку Add.
4. В разделе Issue tracker выберите вашу интеграцию GitLab Issues.
5. В разделе Key выберите задачу, с которой хотите связать тест-кейс.
6. Нажмите Submit.

Чтобы связать запуск с задачей GitLab:

1. Перейдите в Launches.
2. Нажмите на иконку ⋮ справа от запуска, который хотите связать, и выберите Link to an issue.
3. В разделе Issue tracker выберите вашу интеграцию GitLab Issues.
4. В разделе Key выберите задачу, с которой хотите связать тест-кейс.
5. Нажмите Submit.