# Testforge. Функциональный мониторинг

Для доступа к экрану "Функционального мониторинга" перейдите в соответсвующий раздел «Testforge» в основном меню системы.

Изображение

# Создание проекта функционального тестирования

Для создания нового проекта на экране Testforge нажмите «Создать проект» в правом верхнем углу.

Если у вас еще нет доступных проектов Функционального тестирования - начальная страница экрана Testforge начнется с формы создания проекта.

В открывшемся окне укажите Тип проекта:

  • Автономный - Конфигурация и выполнение тестов происходит во внешней системе, проект содержит лишь отчеты о тестировании.
  • Управляемый - Конфигурация, выполнение тестов и хранение отчетов тестирования происходит внутри Testforge.

Выберите Рабочую Группу-Владельца, введите Название, дополнительно можете указать краткое Описание проекта.

Нажмите «Добавить» – будет создан новый проект в состоянии Остановлен, а вы будете перенаправлены на страницу проекта.

# Настройка проекта

# Основная информация

Для изменения основных параметров проекта (Название, Владелец, Описание, Тип проекта), перейдите на вкладку «Общая информация», укажите в нужном поле новое значение и нажмите «Сохранить».

Предупреждение

При изменении типа проекта все настройки проекта будут очищены.

# Метки

Вы можете добавить на проект метки для более удобной навигации – для этого нажмите «Добавить метки» рядом с названием проекта и введите название метки. Если нужная метка уже существует, она прикрепится к проекту, если нет – выберите цвет будущей метки и она будет автоматически создана.

# Доступ

Для настройки доступа Рабочих Групп к проекту, перейдите во вкладку «Доступ».

Для выдачи Рабочим Группам прав на просмотр или редактирование проекта, выберите одну или несколько групп в поле «Выберите рабочие группы», выберите просмотр или редактирование в поле рядом и нажмите «Выдать доступ».

Для изменения выданного доступа, измените тип доступа в селекторе напротив названия соответствующей группы.

Для отзыва доступа, нажмите на значок «🗑» напротив названия группы.

# Конфигурация Автономного проекта

Для начала приёма сборок функционального тестирования, сконфигурируйте проект:

  1. На вкладке «Общая информация» сгенерируйте и скопируйте API-ключ – нажмите «Обновить», затем «Копировать».
  2. Выберите парсер сборок – в селекторе «Парсер отчетов» выберите подходящий парсер для обработки поступающих в проект сборок. Доступны парсеры:
  3. Перейдите в систему автоматического выполнения сценариев тестирования и укажите скопированный ранее ключ API:
    • Для Jenkins, например, перейдите в настройки проекта и вставьте в поле «Выполнить команду Shell» команду export X_FMONQ_PROJECT_KEY=<ключ API>, где <ключ API> – скопированный на 1-м шаге ключ (см. подробнее про API).

      Изображение

# Конфигурация Управляемого проекта

При использовании Управляемых проектов Testforge запуск функциональных тестов производится на внешних стендах функционального тестирования при помощи Агентов monq.

Управляющим элементом на стенде функционального тестирования является внешний Агент monq.

Прежде чем переходить к конфигурации Управляемого проекта Testforge необходимо подключить Агент к своему пространству monq.

# Задание

Для запуска функционального теста необходимо сконфигурировать Задание на языке Yaml, которое будет выполняться на внешнем Агенте.

Пример такого задания, может иметь следующий вид:

name: TestforgeSample - Task
env:
  BUILD_NUMBER: $.vars.params.buildId
  PROJECT: $.vars.params.projectId
  X_FMONQ_PROJECT_KEY: $.vars.params.projectKey
  MONQ_URL: $.vars.params.monqUrl
  HUB_URL: $.vars.params.hubUrl
jobs:
  - steps:
      - name: Run test 
        run: <команда запуска функционального теста>

в указанном примере Задания в секции env определяются необходимые переменные окружения и выполняется команда запуска функционального теста в секции steps.

# Переменные окружения

  • Системные значения (read-only)
    • $.vars.params.buildId - порядковый номер запускаемой сборки функционального теста.
    • $.vars.params.projectId - идентификатор текущего проекта.
    • $.vars.params.projectKey - API-ключ текущего проекта.
    • $.vars.params.testforgeUri - текущий домен пространства monq.
  • Пользовательские переменные - можно добавить любое количество пользовательских переменных, которые можно использовать в Задании по следующему шаблону:
    • $.vars.params.<название переменной>

Для добавления пользовательской переменной:

  1. Нажмите кнопку +Добавить переменную
  2. Задайте Название переменной
  3. Выберите Тип переменной (String или Number)
  4. Задайте Значение по умолчанию.
  5. При необходимости Сделайте защищенной переменную, если это пароль или токен, который необходимо скрыть в проекте.

image

# Расписание запуска задания

Расписание планировщика заданий задается в стандартном формате CRON (opens new window).

Например, для запуска Задания каждые 30 минут, расписание будет выглядеть следующим образом:

*/30 * * * *

image

# Агент

Распределение заданий на Агент производится по заданным в Координаторах меткам. Выберите метку Агента в селекторе Метка агента, назначенную в Координаторе подключенного Агента.

# Парсер

Выберите парсер сборок – в селекторе «Парсер» выберите подходящий парсер для обработки поступающих в проект сборок. Доступны парсеры:

image

После завершения конфигурации проекта нажмите кнопку Сохранить и нажмите кнопку Запустить, чтобы инициализировать планировщик и начать функционально тестирование проекта.

Для Управляемых проектов существует возможность ручного запуска Функционального теста.

Чтобы выполнить внеплановую сборку теста в контекстном меню - в верхнем правом углу экрана управления проектом, выберите Выполнить сборку.

Задание будет немедленно передано на Агент и произойдет запуск функционального теста.

# Управление проектом

Для изменения состояния проекта воспользуйтесь кнопками в правом верхнем углу страницы:

  • Нажмите «Запустить», чтобы проект начал приём отчетов функциональных тестов.

  • Нажмите «Остановить», чтобы проект прекратил приём отчетов.

    Опционально – добавьте метки или измените описание, чтобы указать причину остановки проекта и включите «Отложенный запуск», чтобы автоматически Запустить проект через выбранное время. При некорректном заполнении времени отложенного запуска - остановка проекта невозможна.

  • Нажмите «Архивировать», чтобы проект прекратил приём отчетов и перестал отображается на экране проектов по умолчанию.

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

ВНИМАНИЕ

Вы можете запускать только сконфигурированные проекты.

  • Для Автономных проектов обязательным условием необходимо указание Парсера отчетов тестирования.
  • Для Управляемых проектов обязательным условием необходимо указание:
    • Парсера
    • Метки агента
    • Расписания запуска задания

# Связь проектов с РСМ

Для привязки проекта к КЕ РСМ используйте селектор на вкладке «Список связанных КЕ».

Для того, чтобы отвязать проект от КЕ, нажмите «🗑» напротив названия КЕ.

# Навигация по проектам

Для навигации по проектам функционального мониторинга, вернитесь на основной экран Testforge.

На экране Testforge представлена информация по доступным текущему пользователю проектам в табличном виде и содержит следующие данные:

  • Название и описание проекта.
  • Результат последних 5-ти сборок и дату последней сборки.
  • Тип проекта (иконка) - Автономный или Управляемый проект.
  • Владелец проекта - Рабочая группа которой принадлежит проект.
  • Метки

# Фильтрация проектов

Основным инструментов фильтрации и навигации по проектам на экране является рубрикатор – набор быстрых фильтров по основным параметрам проектов. Находится в левой области экрана.

Для использования рубрикатора, раскройте в таблице слева один из параметров:

  • Метки
  • Владелец
  • Карта РСМ
  • КЕ
  • Состояние проекта
  • Тип
  • Статус последней сборки

и выберите значение, по которому будут отфильтрованы проекты.

Значения всех выбранных параметров отобразятся в фильтре справа от строки поиска.

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

Справка

Условия фильтрации, содержащие разные значения одного и того же параметра, объединяются через логический оператор ИЛИ, а значения разных параметров – через логический оператор И.

Для исключения условия из фильтра нажмите на крестик справа от пары параметр-значение в рубрикаторе или справа от строки поиска.

# Избранные проекты

Для сброса всех условий фильтрации выберите «Все проекты» вверху рубрикатора. Выберите «Избранные проекты» для отображения на экране только избранных проектов.


После конфигурации необходимого фильтра, вы можете сохранить его для быстрого доступа – нажмите «Сохранить как» в верхней области страницы и введите имя.

После сохранения, фильтр станет доступен для выбора в списке слева от кнопки «Сохранить». Выберите его и проекты отфильтруются по соответствующим условиям.

Откройте список и отметьте фильтр значком «⭐️» (Избранное) – фильтр отобразится на панели быстрого доступа вверху экрана.

Вы можете редактировать и удалять выбранный фильтр – откройте дополнительное меню справа от кнопки «Сохранить» и выберите нужное действие:

  • Сохранить как – сохранение фильтра под новым названием
  • Переименовать – изменение названия выбранного фильтра
  • Сбросить изменения – сброс условий фильтрации до последних сохраненных
  • Удалить запрос – удаление фильтра

# Быстрые действия

На экране Testforge вы можете взаимодействовать с проектами без перехода на страницы проектов.

Для управления метками проекта, нажмите на поле «Добавить метки» справа от названия проекта – в открывшемся списке выберите метку из доступных для добавления проекту. Если нужной метки не существует – она будет создана автоматически.

Для удаления метки с проекта нажмите крестик справа от метки.

Для быстрого копирования ключа API проекта откройте контекстное меню справа от меток проекта и нажмите «Копировать API-ключ».

Для быстрого изменения состояния проекта откройте контекстное меню справа от меток проекта и выберите нужное:

  • «Запустить проект»
  • «Остановить проект»
  • «Архивировать проект»

Для быстрого перехода на нужную вкладку страницы проекта откройте контекстное меню справа от меток проекта и выберите нужное:

  • «Открыть настройки доступа»
  • «Открыть связанные КЕ»

Для быстрого клонирования проекта откройте контекстное меню справа от меток проекта и выберите «Клонировать проект».

Нажмите «⭐️» справа от контекстного меню чтобы добавить проект в Избранное или снять данную отметку.

Избранные проекты всегда отображаются вверху списка.