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

В этой статье описывается, как настроить интеграцию с таск-трекером GitLab (GitLab Issues), чтобы иметь возможность добавлять ссылки на задачи в тест-кейсы и запуски в ТестОпс. Если вам нужно настроить интеграцию с 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 — название, которое поможет вам распознать токен (например, «Токен для ТестОпс»).
   • Expiration date — любая дата в пределах года с текущей даты. После этой даты интеграция перестанет работать, и вам нужно будет создать новый токен для продолжения использования интеграции.

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

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

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

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

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

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

2. Перейдите в раздел Администрирование → Интеграции.

3. Нажмите + Добавить интеграцию в правом верхнем углу страницы.

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

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

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

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

7. Нажмите Добавить интеграцию.

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

1. Откройте ваш проект в ТестОпс.

2. Перейдите в раздел Настройки → Интеграции.

3. Найдите интеграцию с GitLab Issues и нажмите Добавить интеграцию.

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

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

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

6. Нажмите Добавить интеграцию.

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

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

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

1. Перейдите в раздел Тест-кейсы.
2. Откройте тест-кейс, который вы хотите связать с задачей, и нажмите на значок карандаша в правой части страницы, напротив Связанные задачи из баг-трекера.
3. В появившемся окне нажмите + Добавить.
4. В поле Баг-трекер выберите вашу интеграцию с GitLab Issues.
5. В поле Ключ выберите задачу, с которой хотите связать тест-кейс.
6. Нажмите Отправить.

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

1. Перейдите в раздел Запуски.
2. Нажмите ⋯ справа от запуска, который вы хотите связать с задачей, и выберите Изменить.
3. В открывшемся окне нажмите + Добавить в разделе Связанные задачи из баг-трекера.
4. В поле Баг-трекер выберите вашу интеграцию с GitLab Issues.
5. В поле Ключ выберите задачу, с которой хотите связать запуск.
6. Нажмите Отправить.