Интеграция с Redmine

Интеграция с Redmine позволяет:

• связывать сущности ТестОпс (тест-кейсы, запуски, результаты тестов, дефекты, карантин) с задачами Redmine (см. Ссылки на задачи из таск-трекеров);
• создавать задачи Redmine через интерфейс открытого дефекта в ТестОпс (см. Связывание дефектов с задачами);
• просматривать связанные тест-кейсы из ТестОпс в задачах Redmine;
• просматривать связанные запуски и результаты тестов из ТестОпс в задачах Redmine.

Примечание

Чтобы настроить или удалить любую интеграцию ТестОпс с внешней системой, необходима глобальная роль «Администратор» в инстансе ТестОпс и, как правило, права администратора инстанса внешней системы.

Настройка интеграции

Чтобы настроить интеграцию с Redmine:

1. В Redmine включите доступ к сервису REST API.

2. Подключите интеграцию с Redmine на уровне инстанса ТестОпс.

3. Добавьте настроенное подключение к Redmine в проект ТестОпс.

4. Установите и настройте плагин Allure TestOps в Redmine, указав ID настроенного подключения к Redmine.

   Примечание

   Для интеграции с Redmine используется плагин Allure TestOps, который совместим с ТестОпс.

1. Настройте связь от ТестОпс к Redmine

Чтобы получить возможность связывать сущности ТестОпс с задачами Redmine, а также создавать задачи Redmine из карточек дефектов в ТестОпс, настройте первую связь интеграции: от ТестОпс к Redmine.

1.1. Включите доступ к Redmine REST API

1. Перейдите в ваш инстанс Redmine.
2. В левом верхнем углу перейдите в раздел Administration → Settings.
3. Перейдите на вкладку API.
4. Поставьте галочку напротив Enable REST web service.
5. Нажмите Save.

1.2. Подключите интеграцию с Redmine на уровне инстанса ТестОпс

1. Перейдите в ваш инстанс ТестОпс.

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

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

4. В списке доступных интеграций выберите Redmine.

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

   • Название подключения — введите название, которое поможет вам позже распознать интеграцию (например, Redmine production).

   • Endpoint — введите URL-адрес вашего инстанса Redmine (например, https://example.redmine.com/).

   • Тип учетных данных — нажмите на выпадающий список и выберите тип учетных данных Redmine, который будет поддерживать интеграция:

     • Все (глобальные и проектные) — интеграция может работать как с глобальными, так и с проектными учетными данными;
     • Только глобальные — интеграция может работать только с глобальными учетными данными;
     • Только проектные — интеграция может работать только с проектными учетными данными.

     Примечание

     Подробнее о поддерживаемых типах учетных данных см. Интеграции с внешними системами → Глобальные и проектные учетные данные

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

7. Если интеграция может работать с глобальными учетными данными Redmine, в секции Глобальные учетные данные введите имя пользователя и пароль нужной учетной записи в Redmine.

8. Нажмите Добавить подключение.

1.3. Добавьте настроенное подключение к Redmine в проект ТестОпс

Чтобы добавить настроенное подключение к Redmine в нужный проект ТестОпс, воспользуйтесь одним из способов:

1. В ТестОпс перейдите в раздел Администрирование → Интеграции.

2. В списке настроенных интеграций найдите и откройте интеграцию с Redmine.

3. В списке настроенных подключений найдите и откройте ваше подключение к Redmine.

4. Нажмите Добавить в проект.

5. В списке доступных проектов выберите нужный проект ТестОпс.

6. Если интеграция может работать и с глобальными, и с проектными учетными данными Redmine, в поле Тип учетных данных нажмите на выпадающий список и выберите вариант, который будет использоваться в проекте:

   • Проектные — использовать проектные учетные данные для подключения к Redmine;
   • Глобальные — использовать глобальные учетные данные для подключения к Redmine.

7. Если интеграция будет работать с проектными учетными данными Redmine, в секции Проектные учетные данные введите имя пользователя и пароль нужной учетной записи в Redmine.

8. Нажмите Добавить в проект.

2. Настройте связь от Redmine к ТестОпс

Чтобы получить возможность просматривать сущности ТестОпс в задачах Redmine, настройте обратную связь интеграции: от Redmine к ТестОпс.

2.1. Найдите ID подключения к Redmine в ТестОпс

1. В ТестОпс перейдите в раздел Администрирование → Интеграции.

2. В списке настроенных интеграций найдите и откройте интеграцию с Redmine.

3. В списке настроенных подключений найдите и откройте ваше подключение к Redmine.

4. В URL-адресе открытого подключения найдите и скопируйте ID этого подключения.

   Пример ID в URL-адресе подключения

   Предположим, URL-адрес настроенного подключения к Redmine выглядит как https://testops.example.com/admin/integration/redmine/connections/6/projects. Число 6 в данном случае — ID подключения, которое необходимо скопировать.

   Этот ID понадобится вам на следующем шаге.

2.2. Подключите плагин для Redmine

1. Скачайте архив с плагином на странице testops-redmine.

2. В директории, в которой развернут ваш инстанс Redmine, перейдите в /plugins/ и создайте директорию testops.

3. Извлеките содержимое архива в созданную директорию.

4. Перезапустите ваш инстанс Redmine и войдите в него.

5. В левом верхнем углу перейдите в раздел Administration → Plugins.

6. Найдите плагин Allure Testops for Redmine и справа от него нажмите Configure.

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

   • Allure Endpoint — введите URL-адрес вашего инстанса ТестОпс.
   • Allure TestOps version — нажмите на выпадающий список и выберите 4.x.
   • Issue Tracker Key — введите ID подключения к Redmine, который вы скопировали на шаге 2.1.

8. Нажмите Apply.

9. Перейдите в ваш проект Redmine.

10. Перейдите на вкладку Settings.

11. На вкладке Project в секции Modules поставьте галочку напротив Allure testops.

12. Нажмите Save.

Удаление интеграции

Вы можете удалить интеграцию с Redmine двумя способами — на уровне всего инстанса ТестОпс (через раздел Администрирование) или на уровне отдельного проекта (через настройки проекта).

Важно

Последствия удаления интеграции:

• Удаление на уровне инстанса — все связи с задачами Redmine, которые относятся к интеграции, будут удалены из сущностей ТестОпс. Это действие необратимо — восстановить удаленные ссылки будет невозможно.

• Удаление на уровне проекта — все связи с задачами Redmine, которые относятся к интеграции, будут сохранены в сущностях ТестОпс, но вы не сможете создавать новые связи для этого проекта.

1. В ТестОпс перейдите в раздел Администрирование → Интеграции.

2. В списке настроенных интеграций найдите и откройте интеграцию с Redmine.

3. В списке настроенных подключений найдите ваше подключение к Redmine и убедитесь, что оно не используется в проектах ТестОпс.

   Если интеграция подключена к проектам, удалите ее из них. Для этого откройте карточку подключения к Redmine и напротив названия каждого проекта нажмите ⋯ → Удалить из проекта → Да, удалить.

4. Напротив нужного подключения к Redmine нажмите ⋯ → Удалить → Да, удалить.