Интеграция с Яндекс Трекером
Интеграция с Яндекс Трекером позволяет:
- связывать сущности ТестОпс (тест-кейсы, запуски, результаты тестов, дефекты, карантин) с задачами Яндекс Трекера (см. Ссылки на задачи из таск-трекеров);
- создавать задачи Яндекс Трекера через интерфейс открытого дефекта в ТестОпс (см. Связывание дефектов с задачами из таск-трекеров);
- просматривать связанные запуски из ТестОпс в задачах Яндекс Трекера.
Примечание
Чтобы настроить или удалить любую интеграцию ТестОпс с внешней системой, необходима глобальная роль «Администратор» в инстансе ТестОпс и, как правило, права администратора инстанса внешней системы.
Настройка интеграции и подключений с Яндекс Трекером
Чтобы настроить интеграцию с Яндекс Трекером:
- Создайте учетные данные в Яндекс.
- Получите идентификатор организации в Яндекс.
- Подключите интеграцию с Яндекс Трекером на уровне инстанса ТестОпс.
- Добавьте настроенное подключение к Яндекс Трекеру в проект ТестОпс.
1. Создайте учетные данные в Яндекс
Интеграция с Яндекс Трекером поддерживает два типа аутентификации — с использованием OAuth2-токена или IAM-токена. OAuth2-токен доступен для организаций Яндекс 360 и Yandex Cloud, IAM-токен — только для организаций Yandex Cloud с использованием сервисных аккаунтов.
Чтобы подготовить учетные данные, воспользуйтесь одним из способов в зависимости от нужного типа аутентификации:
Создайте OAuth2-токен в Яндекс, добавив разрешения:
- Чтение из трекера;
- Запись в трекер;
- Аутентификация в облаке.
Сохраните токен в безопасном месте, он понадобится для подключения интеграции с Яндекс Трекером в ТестОпс.
2. Получите идентификатор организации в Яндекс
Перейдите в ваш инстанс Яндекс Трекера → раздел Администрирование → Организации.
Под названием организации скопируйте ее идентификатор — значение поля ID.
Совет
Идентификатор организации Яндекс 360 — числовой (например, 7016944). Идентификатор организации Yandex Cloud — буквенно-цифровой (например, bpf1smsil5q0). Укажите идентификатор той организации, в которой используется Яндекс Трекер.
Для организации Yandex Cloud идентификатор можно получить другим способом — подробнее см. официальную документацию Яндекс.
Сохраните идентификатор организации в безопасном месте, он понадобится для подключения интеграции с Яндекс Трекером в ТестОпс.
3. Подключите интеграцию с Яндекс Трекером на уровне инстанса ТестОпс
Перейдите в ваш инстанс ТестОпс → раздел Администрирование → Интеграции.
Нажмите Добавить интеграцию.
В списке доступных интеграций выберите Яндекс Трекер.
Заполните поля:
Название подключения — введите название, которое поможет вам распознать интеграцию (например, Яндекс Трекер production).
Endpoint — введите URL-адрес вашего инстанса Яндекс Трекера (например, https://tracker.yandex.ru).
Endpoint для вызовов API — введите URL-адрес API Яндекс Трекера:
- для облачной версии Яндекс Трекера укажите https://api.tracker.yandex.net;
- для серверной версии Яндекс Трекера укажите собственный эндпоинт.
Тип учетных данных — нажмите на выпадающий список и выберите тип учетных данных Яндекс Трекера, который будет поддерживать интеграция:
- Все (глобальные и проектные) — интеграция может работать как с глобальными, так и с проектными учетными данными;
- Только глобальные — интеграция может работать только с глобальными учетными данными;
- Только проектные — интеграция может работать только с проектными учетными данными.
Примечание
Подробнее о поддерживаемых типах учетных данных см. Интеграции с внешними системами → Учетные данные внешних систем.
Если ваш инстанс Яндекс Трекера использует самоподписанный SSL-сертификат, уберите галочку напротив Проверка SSL-сертификата.
Если интеграция может работать с глобальными учетными данными Яндекс Трекера, в секции Глобальные учетные данные:
Нажмите Добавить подключение.
В разделе Администрирование → Интеграции появится интеграция с Яндекс Трекером с одним автоматически созданным подключением.
4. Добавьте настроенное подключение к Яндекс Трекеру в проект ТестОпс
Чтобы добавить настроенное подключение к Яндекс Трекеру в нужный проект ТестОпс, воспользуйтесь одним из способов:
В ТестОпс перейдите в раздел Администрирование → Интеграции.
В списке настроенных интеграций найдите и откройте интеграцию с Яндекс Трекером.
В списке настроенных подключений найдите и откройте ваше подключение к Яндекс Трекеру.
Нажмите Добавить в проект.
В списке доступных проектов выберите нужный проект ТестОпс.
Если интеграция может работать и с глобальными, и с проектными учетными данными Яндекс Трекера, в поле Тип учетных данных нажмите на выпадающий список и выберите вариант, который будет использоваться в проекте:
- Проектные — использовать проектные учетные данные для подключения к Яндекс Трекеру;
- Глобальные — использовать глобальные учетные данные для подключения к Яндекс Трекеру.
Если интеграция будет работать с проектными учетными данными Яндекс Трекера, в секции Проектные учетные данные:
Нажмите Добавить в проект.
Удаление подключений и интеграции с Яндекс Трекером
Вы можете удалить подключение к интеграции с Яндекс Трекером двумя способами — на уровне отдельного проекта (через настройки проекта) или на уровне всего инстанса ТестОпс (через раздел Администрирование).
Удаление подключения на уровне проекта
Важно
Последствия удаления всех подключений из интеграции с Яндекс Трекером на уровне проекта:
- Подключения к интеграции с Яндекс Трекером перестанут отображаться в списке подключений проекта, но продолжат работать в других проектах инстанса, в которых они были добавлены, и сохранятся в разделе Администрирование → Интеграции.
- Интеграция с Яндекс Трекером перестанет отображаться в списке интеграций проекта, но сохранится в разделе Администрирование → Интеграции.
- Все связи с задачами Яндекс Трекера, которые относятся к интеграции, будут сохранены в сущностях ТестОпс, но вы не сможете создавать новые связи для этого проекта.
Чтобы удалить подключение на уровне проекта:
- Перейдите в ваш проект ТестОпс → раздел Настройки → Интеграции.
- В списке настроенных интеграций найдите и откройте интеграцию с Яндекс Трекером.
- Напротив нужного подключения к Яндекс Трекеру нажмите
⋯→ Удалить → Да, удалить.
Подключение перестанет работать в вашем проекте.
Удаление подключения на уровне инстанса
Важно
Последствия удаления всех подключений из интеграции с Яндекс Трекером на уровне инстанса:
- Подключения и интеграция с Яндекс Трекером будут полностью удалены.
- Все связи с задачами Яндекс Трекера, которые относятся к интеграции, будут удалены из сущностей ТестОпс. Это действие необратимо — восстановить удаленные ссылки будет невозможно.
Чтобы удалить подключение на уровне инстанса:
- Перейдите в ваш инстанс ТестОпс → раздел Администрирование → Интеграции.
- В списке настроенных интеграций найдите и откройте интеграцию с Яндекс Трекером.
- В списке настроенных подключений откройте карточку нужного подключения и напротив названия каждого проекта нажмите
⋯→ Удалить из проекта → Да, удалить. - Нажмите Назад в интеграцию, чтобы вернуться к списку подключений.
- Напротив нужного подключения к Яндекс Трекеру нажмите
⋯→ Удалить → Да, удалить.
Подключение перестанет работать во всех проектах инстанса.
Устранение неполадок
Не устанавливается соединение с Яндекс Трекером («Insufficient scope for this Yandex.passport account»)
Если при попытке установить соединение в интеграции с Яндекс Трекером возникает ошибка «Insufficient scope for this Yandex.passport account. Yandex.passport account lacks»:
- Откройте приложение в Яндекс OAuth, которое было создано для OAuth2-токена на шаге 1.
- Убедитесь, что в разрешениях выбрано Аутентификация в облаке.
- Пересоздайте OAuth2-токен и обновите его в настройках подключения в ТестОпс.