Часто задаваемые вопросы (FAQ)

Общее использование

Каковы системные требования для ТестОпс? Сколько тестов я могу запускать без ухудшения производительности?

Чтобы ознакомиться с системными требованиями ТестОпс, см. Архитектура → Требования к оборудованию.

Если возникают проблемы с производительностью инстанса, проверьте, что:

• сервер базы данных не работает в контейнере;
• в качестве хранилища используется S3.

Если вы запускаете большое количество тестов (несколько тысяч ежедневно), масштабируйте сервис testops до трех инстансов.

Какие браузеры поддерживает ТестОпс?

ТестОпс полностью совместим с последними версиями десктопных браузеров:

• Google Chrome;
• Microsoft Edge (на движке Chromium);
• Safari;
• Mozilla Firefox;
• Opera (на движке Chromium).

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

Какие методы аутентификации доступны в ТестОпс?

В серверной версии ТестОпс поддерживается аутентификация через:

• локальные учетные записи (встроенный метод);
• LDAP;
• SAML 2.0;
• OpenID Connect (например, с Keycloak, Microsoft Entra ID или Okta).

В облачной версии ТестОпс доступна аутентификация только через локальные учетные записи.

Когда сбой теста считается решенным?

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

Как добавить кастомные поля и другие метаданные к результатам автоматизированных тестов?

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

Как установить статус результата теста на что-то другое, кроме «Успешный» или «Неуспешный»?

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

Как указать подробную информацию о статусе шага?

Во время выполнения теста наведите курсор на нужный шаг сценария и нажмите ⋯ → Отметить как пройденный. В открывшемся окне можно выбрать статус, категорию ошибки и указать подробности прохождения шага.

Как восстановить удаленный тест-кейс?

Удаленные тест-кейсы хранятся в разделе Корзина. Чтобы восстановить тест-кейс, см. Удаление и восстановление тест-кейса → Восстановление тест-кейса из раздела «Корзина».

Как создать копию тест-кейса и переместить тест-кейсы между проектами?

Вы можете создавать копии тест-кейсов и перемещать тест-кейсы между проектами по одному или с использованием панели массовых операций. Подробнее см. Клонирование тест-кейса и Перемещение тест-кейса в другой проект.

Как проверить версию и статус ТестОпс?

Чтобы проверить версию ТестОпс, в правом верхнем углу экрана нажмите на ваш аватар. В открывшемся меню пользователя будет указан номер вашей версии ТестОпс.

Чтобы открыть страницу статуса ТестОпс, перейдите по URL-адресу https://<домен_инстанса_ТестОпс>/status (например, https://testops.example.com/status).

Почему мои изменения в тест-кейсе не отображаются в журнале изменений?

Журнал изменений не отслеживает изменения в:

• связанных тест-кейсах;
• карантине;
• связанных задачах из таск-трекеров;
• теле тест-кейсаТело тест-кейса состоит из секций: «Комбинации параметров», «Описание», «Предусловие», «Сценарий», «Ожидаемый результат» и «Постусловие»;
• вложениях.

Подробнее о вкладке Журнал изменений см. Журнал изменений тест-кейса.

Почему виджет на дашборде не отображает данные, несмотря на правильный AQL или отсутствие AQL?

Большинство виджетов, отображающих данные в хронологическом порядке, по умолчанию показывают данные только за последние 14 дней. Если данные, соответствующие запросу AQL, старше 2 недель, виджет будет пустым.

Чтобы изменить период отображения данных, см. Настройка виджетов → Период отображения данных в виджетах.

Можно ли использовать функции AQL в виджетах дашборда?

Нет. Функции AQL, такие как now(), dayStartUtc(), weekAgo() и currentUser(), не поддерживаются в виджетах.

Какой синтаксис регулярных выражений поддерживает ТестОпс?

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

Примеры шаблонов поиска по сообщению об ошибке

Цель	Регулярное выражение
Найти все ошибки, содержащие слово Timeout	Timeout
Найти все ошибки HTTP с кодом 4xx	\b4\d{2}\b
Найти ошибки, содержащие выражение File not found	File not found: .+

Примеры шаблонов поиска по стек-трейсу

Цель	Регулярное выражение
Найти все ошибки, произошедшие из-за сбоя при вызове определенного эндпоинта	GET.*api/v1/users/.*500
Найти все ошибки, произошедшие из-за отсутствия файла application-prod.yml	FileNotFoundException.*application-prod\.yml
Найти ошибки подключения к базе данных PostgreSQL на определенном хосте	Connection refused.*postgresql.*192\.168\.1\.100

Полезные ресурсы

Проверить регулярные выражения можно на сайте regex101.com, для проверки необходимо выбрать соответствующий синтаксис. На сайте также доступна справка по всем элементам регулярных выражений.

База данных и хранилище

Где ТестОпс хранит данные (тест-кейсы и артефакты тестов)?

ТестОпс использует два типа хранилищ:

• PostgreSQL — для основных данных (например, проектов, тест-кейсов, результатов тестов);
• S3-совместимое хранилище — для артефактов тестов (вложений и других файлов).

Подробнее см. Архитектура → Требования к хранилищу.

Артефакты тестов занимают слишком много места. Можно автоматически удалять ненужные файлы?

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

Как создать резервную копию базы данных ТестОпс или перенести данные в другой инстанс?

Вы можете создать резервную копию базы данных ТестОпс утилитами PostgreSQL — pg_dump и pg_restore. Они же позволяют перенести данные в другой инстанс. Подробнее см. Перенос данных между инстансами.

Почему не уменьшается размер базы данных при настроенных правилах очистки?

PostgreSQL VACUUM

Правила очистки удаляют данные сценариев и ссылки на артефакты из базы данных, но место в ней освобождается не сразу. Чтобы окончательно удалить данные и ускорить обработку запросов, PostgreSQL использует процедуру VACUUM.

Периодически выполняйте процедуру VACUUM вручную или настройте AUTOVACUUM — особенно для таблиц, из которых данные удаляются часто.

Трейсы и сообщения

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

Чтобы сэкономить место в базе данных, рекомендуем сократить длинные трейсы и сообщения перед добавлением их в результаты тестов. Другой вариант — хранить трейсы как вложения к результатам тестов.

Лицензирование и управление пользователями

Какие виды лицензий поддерживает ТестОпс и как ими управлять?

ТестОпс использует модульную систему лицензирования. Подробнее см. Система лицензирования в ТестОпс.

Как завершить активные сессии ТестОпс для всех пользователей?

Данные о сессиях пользователей хранятся в Redis. Чтобы завершить все активные сессии, перезапустите процесс Redis. Если используются функции сохранения Redis, отключите их.

Облачная версия ТестОпс

Сколько места для хранения данных доступно в облачной версии?

Облачная версия ТестОпс включает 60 ГБ для хранения данных.

Нужно ли вручную обновлять облачную версию ТестОпс?

Нет, не нужно. Облачные инстансы ТестОпс автоматически обновляются до последней стабильной версии.

Как мигрировать с серверной версии ТестОпс на облачную версию?

См. Миграция с серверной версии ТестОпс на облачную.

Серверная версия ТестОпс

Нужно ли настраивать PersistentVolume для развертывания Kubernetes с S3?

Нет, не нужно. Подробнее о настройке S3-совместимого хранилища для хранения артефактов тестов см. Установка ТестОпс версии 5.x в Kubernetes.

Как перейти на RabbitMQ 4.x с кворумными очередями?

Чтобы перейти на RabbitMQ 4.x с кворумными очередями:

1. Остановите балансировщик нагрузки и подождите 5 минут. Убедитесь, что все очереди в RabbitMQ полностью обработаны.

2. Остановите все сервисы приложения ТестОпс.

3. Полностью удалите RabbitMQ предыдущей версии, включая директорию с данными (mnesia), в которой RabbitMQ хранит метаданные об очередях, vhost и пользователях.

4. Установите RabbitMQ версии 4.0 или выше.

5. Создайте пользователя и vhost. При создании vhost выберите тип очередей quorum.

6. Измените конфигурационные файлы ТестОпс в зависимости от вашего типа развертывания:

   В файле values.yaml добавьте параметры в секцию env.open (или в секцию, где задаются переменные окружения сервиса testops):

   env:
     open:
       ALLURE_RABBIT_QUORUM_ENABLED: true
       ALLURE_RABBIT_QUORUM_INITIALGROUPSIZE: 3

   Количество нод должно быть нечетным и не менее 3.

7. Запустите ТестОпс и включите балансировщик нагрузки.

Запуски

Как предотвратить создание тест-кейсов при запуске тестов на ветках, отличных от master?

Чтобы тест-кейсы создавались и обновлялись только при выполнении автоматизированных тестов на ветках master или release, настройте политику генерации документации в правилах обработки запусков. Для этого используйте AQL-запросы по метаданным запусков, например evv["Branch"] = "master".

Что такое повторные запуски тестов?

Повторные запуски тестов создаются, когда один и тот же тест-кейс выполняется более одного раза в одном запуске. Их можно определить по одинаковым ID и окружению результатов тестов.

Чтобы увидеть повторные запуски всех тестов, входящих в запуск:

1. Перейдите в раздел Запуски.
2. Откройте карточку нужного запуска.
3. На вкладке Обзор найдите виджет Перезапуски тестов.

Чтобы увидеть повторные запуски определенного теста:

1. Перейдите в раздел Запуски.
2. Откройте карточку нужного запуска.
3. Перейдите на вкладку Результаты тестов.
4. Откройте карточку нужного результата теста.
5. Перейдите на вкладку Перезапуски.

История повторных запусков тестов не отображается в карточках тест-кейсов.

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