Интеграция с Jira Data Center (Jira Server)

Jira Data Center (ранее Jira Server) — это версия таск-трекера Jira для локального развертывания. В этой статье описывается, как настроить интеграцию между инстансами Jira Data Center и ТестОпс.

• В запуски ТестОпс, результаты тестов и дефекты можно будет добавлять кликабельные ссылки на связанные задачи в Jira.
• В задачах Jira будут отображаться связанные запуски и результаты тестов из ТестОпс.
• При закрытии задачи в Jira будет закрываться связанный дефект в ТестОпс.

Списки запусков и результатов тестов из ТестОпс добавляются в задачи в Jira с помощью компонента iFrame. Для этого ТестОпс не обязательно должен быть доступен с сервера Jira, но он должен быть доступен с устройства пользователя. Это также означает, что работа интеграции может зависеть от настроек браузера пользователя, особенно если инстанс Jira Data Center использует HTTPS. Если у ваших пользователей возникли проблемы при работе с интеграцией, пожалуйста, перейдите в раздел Устранение неполадок или свяжитесь с нашей службой поддержки.

Для добавления ссылки на задачу в тест-кейс вручную Jira должна быть доступна с сервера ТестОпс.

Совет

Для использования автоматической привязки между тест-кейсами и задачами Jira автор теста должен определить связь, используя адаптер Allure Report для своего тестового фреймворка. Пример такого определения:

import { test } from "@playwright/test";
import { allure } from "allure-playwright";

test("Some test", async ({ page }) => {
  allure.label("jira-prod", "BUG-123");
  // ...
});

Этот код свяжет тест с задачей "BUG-123" в таск-трекере "jira-prod". Чтобы добавить ссылку на эту задачу в интерфейс, ТестОпс использует маппинг для значения "jira-prod", как будет показано на шаге 2.4.

Обратите внимание, что хотя приведенный выше пример работает, в реальном проекте мы рекомендуем использовать оберточную функцию вместо указания ключа с помощью allure.label() каждый раз. Более подробную информацию можно найти в документации Allure Report для вашего тестового фреймворка.

1. Установите плагин для Jira

1. В Jira нажмите на значок шестеренки в правом верхнем углу и выберите Manage apps.

   Если нужно, введите пароль администратора Jira.

2. С помощью поля поиска найдите плагин Allure TestOps for Jira.

3. Нажмите Install рядом с плагином.

4. В появившемся окне нажмите Accept & install.

   Дождитесь завершения установки плагина.

Совет

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

2. Включите ссылки Jira в ТестОпс

После завершения этого шага настройки ТестОпс будет поддерживать добавление ссылок на задачи Jira в запусках и в результатах тестов.

Сначала администратору нужно указать URL-адрес сервера Jira.

Затем владельцу проекта нужно создать токен аутентификации в Jira, добавить его в ТестОпс и настроить маппинг задач.

2.1. Укажите URL-адрес Jira в ТестОпс

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

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

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

4. В появившемся окне выберите Jira Server (DC).

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

   • Название — название, которое поможет вам распознать сервер Jira, например, Jira production.
   • Endpoint — URL-адрес сервера Jira, например, https://jira.example.com/.

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

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

2.2. Создайте токен в Jira

Совет

Пропустите этот шаг, если вы планируете использовать свое имя пользователя и пароль в качестве учетных данных.

1. В Jira нажмите на ваш аватар и перейдите в Profile.

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

3. Нажмите Create token.

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

   • Token Name — название, которое поможет вам распознать токен, например «Токен для ТестОпс».
   • Expiry date — срок действия токена. После этой даты интеграция перестанет работать, и вам нужно будет создать новый токен для продолжения использования интеграции. Чтобы создать токен, который никогда не истекает, снимите галочку Automatic expiry.

5. Нажмите Create.

   Новый токен станет временно видимым. Скопируйте его, он понадобится вам на следующем шаге.

2.3. Добавьте учетные данные Jira в ТестОпс

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

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

3. В разделе Доступные интеграции найдите интеграцию Jira Data Center и нажмите Добавить интеграцию рядом с ней.

4. В появившемся окне введите учетные данные для подключения к Jira. Вы можете использовать базовую аутентификацию или аутентификацию с помощью токена.

5. Нажмите Проверить соединение. Если учетные данные верны, через несколько секунд появится сообщение «Соединение установлено».

6. Нажмите Добавить интеграцию, чтобы сохранить настройки.

2.4. Настройте маппинг задач

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

2. Перейдите в раздел Настройки → Задачи из баг-трекера.

3. Нажмите + Создать.

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

   • Ключ — короткий идентификатор интеграции, который вы собираетесь использовать при написании тестов.
   • Баг-трекер — название интеграции, которую вы добавили на шаге 2.1.

   

5. Нажмите Отправить.

3. Настройте встраивание данных в Jira

После завершения этого шага настройки ваш инстанс Jira Data Center будет отображать ссылки на запуски и результаты тестов из ТестОпс.

Сначала убедитесь, что в ТестОпс включены защищенные cookies. Затем найдите ID интеграции и используйте его при настройке плагина в Jira.

3.1. Включите защищенные cookies в ТестОпс

Совет

Этот раздел предполагает, что и ТестОпс, и Jira Data Center настроены на использование зашифрованного протокола HTTPS. В остальных случаях, пожалуйста, свяжитесь с нашей службой поддержки.

По соображениям безопасности браузер пользователя может блокировать обмен cookies между двумя разными сайтами, такими как ТестОпс и Jira. Это может помешать добавлению информации из ТестОпс на страницу Jira.

Чтобы это исправить, убедитесь, что защищенные cookies включены для вашего инстанса ТестОпс.

В файле values.yaml установите для параметра network.tls.secureCookie значение true.

3.2. Найдите ID интеграции в ТестОпс

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

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

3. Найдите интеграцию Jira Data Center.

   Скопируйте ID, который отображается рядом с названием интеграции. Этот ID понадобится вам на следующем шаге.

   

3.3. Настройте плагин в Jira

1. В Jira нажмите на значок шестеренки в правом верхнем углу и выберите Manage apps.

   Если нужно, введите пароль администратора Jira.

2. В меню слева нажмите Manage apps.

3. Разверните раздел Allure TestOps for JIRA и нажмите Configure.

   

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

   • General settings

     • Config — если вы настраиваете плагин впервые или вам нужно добавить интеграцию с новым инстансом ТестОпс, выберите Create new config. В противном случае выберите URL-адрес инстанса, для которого вы хотите обновить настройки.
     • Endpoint — URL-адрес вашего инстанса ТестОпс, например, “https://demo.testops.cloud”. Убедитесь, что в URL-адресе нет слэша в конце, так как это может привести к некорректному поведению плагина.
     • Version — Version 4.x.x.
     • Integration ID — ID, который вы получили в ТестОпс на шаге 3.2.

   • Panels location

     • Test Cases — расположение списка результатов тестов.
     • Launches — расположение списка запусков.

   • Access

     • Selected groups, Groups — для каких групп Jira будет включен плагин. Чтобы включить его для пользователей из всех групп, оставьте опцию Selected groups неотмеченной.
     • Selected projects, Projects — для каких проектов Jira будет включен плагин. Чтобы включить его для пользователей из всех проектов, оставьте опцию Selected projects неотмеченной.

   Важно

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

5. Нажмите Save.

4. Включите синхронизацию жизненных циклов задач

ТестОпс поддерживает вебхуки Jira. Jira использует вебхуки для того, чтобы уведомить внешний сервис об изменении статуса задачи. При получении такого уведомления ТестОпс найдет все дефекты, связанные с задачей, и обновит их статус.

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

4.1. Создайте вебхук в ТестОпс

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

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

3. Найдите интеграцию Jira Data Center и нажмите на ее название.

4. Перейдите на вкладку Вебхуки.

5. Нажмите + Создать вебхук, затем нажмите Подтвердить создание.

6. В появившемся окне нажмите значок Копировать, чтобы скопировать URL-адрес вебхука в буфер обмена.

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

4.2. Добавьте вебхук в Jira

1. В Jira нажмите на значок шестеренки в правом верхнем углу и выберите System.

2. В меню слева нажмите Advanced → WebHooks.

3. Нажмите Create a WebHook.

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

   • Name — название, которое поможет вам распознать вебхук.
   • Status — Enabled.
   • URL — URL-адрес вебхука, который вы получили на шаге 4.1.
   • Issue related events — выберите Issue → updated.

5. Нажмите Create внизу страницы.

Устранение неполадок

В задачах Jira просмотр и управление сущностями ТестОпс осуществляется через компонент iFrame. Ниже приведены примеры возможных ошибок, которые могут отображаться в iFrame, и рекомендации по их устранению.

В разделах iFrame отображается кнопка входа

Если вы вошли в ТестОпс, но все еще видите кнопку Login в задаче Jira, скорее всего, это вызвано настройками безопасности вашего браузера. Следуйте инструкции для вашего браузера ниже, чтобы убедиться, что связь между Jira и iFrame ТестОпс разрешена.

Совет

Эти действия нужно совершить каждому пользователю, который столкнулся с проблемой.

1. Перейдите в настройки браузера в раздел Privacy and security → Third-party cookies (chrome://settings/cookies).

2. Выберите Allow third-party cookies.

   

Разделы iFrame пустые

Пустые разделы iFrame обычно означают, что ваш инстанс Jira использует HTTPS, а ТестОпс использует HTTP. К сожалению, такая конфигурация не поддерживается. Мы рекомендуем переключиться на HTTPS для обоих продуктов. См. Включение HTTPS.

После включения HTTPS для ТестОпс обязательно замените http на https в настройках плагина.

В разделах iFrame отображается сообщение “Couldn't connect to Allure TestOps”

Сообщение “Couldn't connect to Allure TestOps” означает, что в настройках плагина в Jira указан неверный ID интеграции.

Чтобы исправить ошибку:

1. Найдите нужный ID интеграции в ТестОпс.
2. Проверьте, что этот ID указан в настройках плагина.