Интеграция с таск-трекером GitLab
В этой статье описывается, как настроить интеграцию с таск-трекером GitLab (GitLab Issues), чтобы иметь возможность добавлять ссылки на задачи в тест-кейсы и запуски в ТестОпс. Если вам нужно настроить интеграцию с GitLab CI для запуска тестов и получения результатов тестов, см. эту статью.
Если вы уже настроили интеграцию с GitLab CI для вашего инстанса GitLab, единственное, что вам нужно сделать, чтобы связывать тест-кейсы с задачами GitLab, это добавить ID проектов GitLab в вашу текущую интеграцию (см. раздел Включите интеграцию для проекта ТестОпс).
Настройка интеграции
Примечание
Чтобы настроить интеграцию в ТестОпс, вы должны иметь доступ к разделам:
- Администрирование — необходимы права администратора инстанса;
- Настройки в конкретном проекте — необходима роль владельца этого проекта.
Чтобы настроить интеграцию с таск-трекером GitLab:
Создайте токен доступа в GitLab.
На уровне инстанса ТестОпс добавьте интеграцию с GitLab, указав:
- название интеграции;
- URL-адрес GitLab.
На уровне инстанса или проекта ТестОпс включите добавленную интеграцию для проекта, указав созданный токен доступа из GitLab.
1. Создайте токен доступа в GitLab
В GitLab нажмите на ваш аватар и выберите Preferences.
В меню слева нажмите Access Tokens.
Нажмите Add new token в правой части страницы.
Заполните поля:
- Token name — название, которое поможет вам распознать токен (например, Токен для ТестОпс).
- Expiration date — срок действия токена (любая дата в пределах года с текущей даты). После указанной даты интеграция перестанет работать. Чтобы возобновить ее работу, вам нужно будет создать новый токен.
Поставьте галочки api и read_api в разделе Select scopes.
Нажмите Create personal access token. После обновления страницы вы должны увидеть созданный токен.
Нажмите на иконку копирования под Your new personal access token, чтобы скопировать токен в буфер обмена.
Cохраните токен в безопасном месте, он понадобится для настройки интеграции в проекте ТестОпс.
Вы также можете использовать токен доступа проекта вместо личного токена доступа, но в этом случае интеграция будет ограничена одним проектом.
2. Добавьте интеграцию с GitLab в ТестОпс
Перейдите в ваш инстанс ТестОпс.
Перейдите в раздел Администрирование → Интеграции.
Нажмите + Добавить интеграцию в правом верхнем углу.
В списке доступных интеграций выберите GitLab.
Заполните поля:
- Название — название, которое поможет вам распознать интеграцию, например, GitLab production.
- Endpoint — URL-адрес вашего инстанса GitLab, например, https://gitlab.example.com/.
Если ваш инстанс GitLab использует самоподписанный SSL-сертификат, поставьте галочку напротив Отключить проверку сертификата.
Нажмите Добавить интеграцию.
3. Включите интеграцию для проекта ТестОпс
Чтобы включить интеграцию в нужном проекте ТестОпс воспользуйтесь одним из двух способов ниже:
Перейдите в раздел Администрирование → Интеграции.
В списке настроенных интеграций найдите и откройте вашу интеграцию с GitLab.
Перейдите на вкладку Проекты.
Нажмите + справа от поля поиска.
В выпадающем списке Проект выберите нужный проект.
В разделе Настройки добавьте ID проектов GitLab, которые вы хотите использовать.
Чтобы найти ID проекта, откройте проект в GitLab и перейдите в Settings → General
В разделе Секрет введите токен доступа GitLab, который вы сохранили на шаге 1.
Нажмите Добавить интеграцию, чтобы сохранить настройки.
Добавление ссылок на задачи
После настройки интеграции с GitLab вы можете добавлять ссылки на задачи в ваши тест-кейсы и запуски.
Чтобы связать тест-кейс с задачей GitLab:
- Перейдите в раздел Тест-кейсы.
- Откройте тест-кейс, который вы хотите связать с задачей, и нажмите на значок карандаша в правой части страницы, напротив Связанные задачи из баг-трекера.
- В появившемся окне нажмите + Добавить.
- В поле Баг-трекер выберите вашу интеграцию с GitLab Issues.
- В поле Ключ выберите задачу, с которой хотите связать тест-кейс.
- Нажмите Отправить.
Чтобы связать запуск с задачей GitLab:
- Перейдите в раздел Запуски.
- Нажмите
⋯
справа от запуска, который вы хотите связать с задачей, и выберите Изменить. - В открывшемся окне нажмите + Добавить в разделе Связанные задачи из баг-трекера.
- В поле Баг-трекер выберите вашу интеграцию с GitLab Issues.
- В поле Ключ выберите задачу, с которой хотите связать запуск.
- Нажмите Отправить.