Интеграция с Redmine
Интеграция с Redmine позволяет:
- связывать сущности ТестОпс (тест-кейсы, запуски, результаты тестов, дефекты, карантин) с задачами Redmine (см. Ссылки на задачи из таск-трекеров);
- создавать задачи Redmine через интерфейс открытого дефекта в ТестОпс (см. Связывание дефектов с задачами);
- просматривать связанные тест-кейсы из ТестОпс в задачах Redmine;
- просматривать связанные запуски и результаты тестов из ТестОпс в задачах Redmine.
Примечание
Чтобы настроить или удалить любую интеграцию ТестОпс с внешней системой, необходимы права администратора инстанса ТестОпс и, как правило, права администратора инстанса внешней системы.
Настройка интеграции
Чтобы настроить интеграцию с Redmine:
В Redmine включите доступ к сервису REST API.
На уровне инстанса ТестОпс добавьте интеграцию с Redmine, указав:
- название интеграции;
- URL-адрес Redmine.
На уровне инстанса или проекта ТестОпс включите добавленную интеграцию для проекта, указав учетные данные из Redmine.
Установите и настройте плагин Allure TestOps в Redmine, указав ID добавленной интеграции.
Примечание
Для интеграции с Redmine используется плагин Allure TestOps, который совместим с ТестОпс.
1. Настройте связь от ТестОпс к Redmine
Чтобы получить возможность связывать сущности ТестОпс с задачами Redmine, а также создавать задачи Redmine из карточек дефектов в ТестОпс, настройте первую связь интеграции: от ТестОпс к Redmine.
1.1. Включите доступ к Redmine REST API
- Перейдите в ваш инстанс Redmine.
- В левом верхнем углу перейдите в раздел Administration → Settings.
- Перейдите на вкладку API.
- Поставьте галочку напротив Enable REST web service.
- Нажмите Save.
1.2. Добавьте интеграцию с Redmine в ТестОпс
Перейдите в ваш инстанс ТестОпс.
Перейдите в раздел Администрирование → Интеграции.
Нажмите + Добавить интеграцию в правом верхнем углу страницы.
В списке доступных интеграций выберите Redmine.
Заполните поля:
- Название — название, которое поможет вам позже распознать эту интеграцию, например, Redmine production.
- Endpoint — URL-адрес вашего инстанса Redmine (например, https://example.redmine.com/).
Если ваш инстанс Redmine использует самоподписанный SSL-сертификат, поставьте галочку напротив Отключить проверку сертификата.
Нажмите Добавить интеграцию.
1.3. Включите интеграцию для проекта ТестОпс
Чтобы включить интеграцию в нужном проекте ТестОпс, воспользуйтесь одним из способов:
В ТестОпс перейдите в раздел Администрирование → Интеграции.
В списке настроенных интеграций найдите и откройте вашу интеграцию с Redmine.
Перейдите на вкладку Проекты.
Справа от поля поиска нажмите
+.В выпадающем списке Проект выберите нужный проект ТестОпс.
В появившемся окне заполните поля:
- Имя пользователя — имя пользователя вашей учетной записи в Redmine.
- Пароль — пароль вашей учетной записи в Redmine.
Нажмите Проверить соединение. Если учетные данные верны, через несколько секунд появится сообщение «Соединение установлено».
Нажмите Добавить интеграцию.
2. Настройте связь от Redmine к ТестОпс
Чтобы получить возможность просматривать сущности ТестОпс в задачах Redmine, настройте обратную связь интеграции: от Redmine к ТестОпс.
2.1. Найдите ID интеграции в ТестОпс
Чтобы определить ID добавленной интеграции, воспользуйтесь одним из способов:
В ТестОпс перейдите в раздел Администрирование → Интеграции.
В списке настроенных интеграций найдите вашу интеграцию с Redmine.
Скопируйте ID, который отображается слева от названия интеграции.
Этот ID понадобится вам на следующем шаге.
2.2. Подключите плагин для Redmine
Скачайте архив с плагином на странице testops-redmine.
В директории, в которой развернут ваш инстанс Redmine, перейдите в /plugins/ и создайте директорию testops.
Извлеките содержимое архива в созданную директорию.
Перезапустите ваш инстанс Redmine и войдите в него.
В левом верхнем углу перейдите в раздел Administration → Plugins.
Найдите плагин Allure Testops for Redmine и справа от него нажмите Configure.
Заполните поля:
- Allure Endpoint — URL-адрес вашего инстанса ТестОпс.
- Allure TestOps version — 4.x.
- Issue Tracker Key — ID интеграции Redmine, который вы скопировали на шаге 2.1.
Нажмите Apply.
Перейдите в ваш проект Redmine.
Перейдите на вкладку Settings.
На вкладке Project в секции Modules поставьте галочку напротив Allure testops.
Нажмите Save.
Удаление интеграции
Вы можете удалить интеграцию с Redmine двумя способами — на уровне всего инстанса ТестОпс (через раздел Администрирование) или на уровне отдельного проекта (через настройки проекта).
Важно
Последствия удаления интеграции:
Удаление на уровне инстанса — все связи с задачами Redmine, которые относятся к интеграции, будут удалены из сущностей ТестОпс. Это действие необратимо — восстановить удаленные ссылки будет невозможно.
Удаление на уровне проекта — все связи с задачами Redmine, которые относятся к интеграции, будут сохранены в сущностях ТестОпс, но вы не сможете создавать новые связи для этого проекта.
Перейдите в раздел Администрирование → Интеграции.
В списке настроенных интеграций найдите и откройте вашу интеграцию с Redmine.
Перейдите на вкладку Проекты и убедитесь, что интеграция не используется в проектах ТестОпс.
Если интеграция подключена к проектам, удалите ее из них. Для этого напротив названия каждого проекта нажмите иконку корзины → Удалять.
Перейдите на вкладку Конфигурация.
Нажмите Удалить интеграцию.
Нажмите Удалить.