Интеграция с Yandex Tracker

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

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

Примечание

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

• Администрирование — необходимы права администратора инстанса;
• Настройки в конкретном проекте — необходима роль владельца этого проекта.

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

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

1. Создайте OAuth2-токен в Яндекс.

2. На уровне инстанса ТестОпс добавьте интеграцию с Yandex Tracker, указав:

   • название интеграции;
   • URL-адрес Yandex Tracker.

3. На уровне инстанса или проекта ТестОпс включите добавленную интеграцию для проекта, указав созданный OAuth2-токен из Яндекс.

1. Создайте OAuth2-токен в Яндекс

Чтобы использовать Yandex Tracker, вам нужно аутентифицироваться на стороне Яндекс.

Создание параметров аутентификации описано в официальной документации Yandex Cloud.

https://cloud.yandex.com/en/docs/tracker/concepts/access

Сначала вам нужно аутентифицироваться на https://yandex.com/dev/:

1. Откройте https://oauth.yandex.com/client/new.

2. Добавьте имя сервиса (например, TestOpsIntegration).

3. Выберите Which platform is the app required for? и нажмите Insert URL for development.

   

4. В разделе Data access в поле Permission name:

   • введите ключевое слово tracker и выберите разрешения:
     • Read from tracker;
     • Write in tracker.
   • введите ключевое слово cloud и выберите разрешение Cloud authentication.

5. Для пункта Link to website выберите Insert URL for development и нажмите Create app.

   

6. Вы будете перенаправлены на страницу созданного приложения, на которой вам нужно скопировать ClientID (обратите внимание, что срок действия токена — 1 год).

   

7. Перейдите по ссылке https://oauth.yandex.com/authorize?response_type=token&client_id=application_ID, где application_ID — ваш текущий ClientID из предыдущего шага.

8. Подтвердите авторизацию, если требуется.

   

9. Теперь ваш OAuth2-токен создан и активирован.

   

   Скопируйте и сохраните токен в безопасном месте, он понадобится для настройки интеграции в проекте ТестОпс.

2. Добавьте интеграцию с Yandex Tracker в ТестОпс

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

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

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

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

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

   • Название — название, которое поможет вам распознать интеграцию, например, Yandex Tracker production.
   • Endpoint — URL-адрес инстанса Yandex Tracker. В большинстве случаев это https://tracker.yandex.com.
   • Endpoint for API calls — ТестОпс будет использовать API-эндпоинт по умолчанию (https://api.tracker.yandex.net), если оставить поле Endpoint пустым. См. https://cloud.yandex.com/en/docs/tracker/concepts/access. В большинстве случаев вам не нужно указывать этот параметр.

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

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

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

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

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

2. В списке настроенных интеграций найдите и откройте вашу интеграцию с Yandex Tracker.

3. Перейдите на вкладку Проекты.

4. Справа от поля поиска нажмите +.

5. В выпадающем списке Проект выберите нужный проект ТестОпс.

6. В появившемся окне заполните поля:

   • Organization ID — ID организации (можно найти по ссылке https://tracker.yandex.com/settings).
   • OAuth2 token — OAuth2-токен, который вы сохранили на шаге 1.

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

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

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

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

Важно

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

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

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

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

2. В списке настроенных интеграций найдите и откройте вашу интеграцию с Yandex Tracker.

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

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

4. Перейдите на вкладку Конфигурация.

5. Нажмите Удалить интеграцию.

6. Нажмите Удалить.

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

Не устанавливается тестовое соединение ("Insufficient scope for this Yandex.passport account")

Если при попытке установить тестовое соединение возникает ошибка "Insufficient scope for this Yandex.passport account. Yandex.passport account lacks", перейдите в созданное приложение на стороне Яндекс:

1. Убедитесь, что в разделе Data access выбрано разрешение Сloud authentification.
2. Пересоздайте OAuth2-токен.