Поделиться через


RunVisualStudioTestsusingTestAgent@1 — задача "Выполнение функциональных тестов версии 1"

RunVisualStudioTestsusingTestAgent@1 и сопутствующие задачи (Развертывание агента тестирования Visual Studio) являются устаревшими. Вместо этого используйте задачу "Тест" в Visual Studio. Задача VSTest может выполнять модульные и функциональные тесты. Выполнение тестов для одного или нескольких агентов с помощью параметра задания с несколькими агентами. Используйте задачу Платформы тестирования Visual Studio для выполнения тестов без необходимости в Visual Studio в агенте. Задача VSTest также предоставляет новые возможности, такие как автоматический повторный запуск неудачных тестов.

Синтаксис

# Run functional tests v1
# Deprecated: This task and it’s companion task (Visual Studio Test Agent Deployment) are deprecated. Use the 'Visual Studio Test' task instead. The VSTest task can run unit as well as functional tests. Run tests on one or more agents using the multi-agent job setting. Use the 'Visual Studio Test Platform' task to run tests without needing Visual Studio on the agent. VSTest task also brings new capabilities such as automatically rerunning failed tests.
- task: RunVisualStudioTestsusingTestAgent@1
  inputs:
  # Setup Options
    testMachineGroup: # string. Required. Machines. 
    dropLocation: # string. Required. Test Drop Location. 
  # Execution Options
    testSelection: 'testAssembly' # 'testAssembly' | 'testPlan'. Required. Test Selection. Default: testAssembly.
    #testPlan: # string. Required when testSelection = testPlan. Test Plan. 
    #testSuite: # string. Required when testSelection = testPlan. Test Suite. 
    #testConfiguration: # string. Required when testSelection = testPlan. Test Configuration. 
    sourcefilters: '**\*test*.dll' # string. Required when testSelection = testAssembly. Test Assembly. Default: **\*test*.dll.
    #testFilterCriteria: # string. Optional. Use when testSelection = testAssembly. Test Filter criteria. 
    #runSettingsFile: # string. Run Settings File. 
    #overrideRunParams: # string. Override Test Run Parameters. 
    #codeCoverageEnabled: false # boolean. Code Coverage Enabled. Default: false.
    #customSlicingEnabled: false # boolean. Distribute tests by number of machines. Default: false.
  # Reporting Options
    #testRunTitle: # string. Test Run Title. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #testConfigurations: # string. Test Configurations. 
    #autMachineGroup: # string. Application Under Test Machines.
# Run Functional Tests v1
# Deprecated: This task and it’s companion task (Visual Studio Test Agent Deployment) are deprecated. Use the 'Visual Studio Test' task instead. The VSTest task can run unit as well as functional tests. Run tests on one or more agents using the multi-agent job setting. Use the 'Visual Studio Test Platform' task to run tests without needing Visual Studio on the agent. VSTest task also brings new capabilities such as automatically rerunning failed tests.
- task: RunVisualStudioTestsusingTestAgent@1
  inputs:
  # Setup Options
    testMachineGroup: # string. Required. Machines. 
    dropLocation: # string. Required. Test Drop Location. 
  # Execution Options
    testSelection: 'testAssembly' # 'testAssembly' | 'testPlan'. Required. Test Selection. Default: testAssembly.
    #testPlan: # string. Required when testSelection = testPlan. Test Plan. 
    #testSuite: # string. Required when testSelection = testPlan. Test Suite. 
    #testConfiguration: # string. Required when testSelection = testPlan. Test Configuration. 
    sourcefilters: '**\*test*.dll' # string. Required when testSelection = testAssembly. Test Assembly. Default: **\*test*.dll.
    #testFilterCriteria: # string. Optional. Use when testSelection = testAssembly. Test Filter criteria. 
    #runSettingsFile: # string. Run Settings File. 
    #overrideRunParams: # string. Override Test Run Parameters. 
    #codeCoverageEnabled: false # boolean. Code Coverage Enabled. Default: false.
    #customSlicingEnabled: false # boolean. Distribute tests by number of machines. Default: false.
  # Reporting Options
    #testRunTitle: # string. Test Run Title. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #testConfigurations: # string. Test Configurations. 
    #autMachineGroup: # string. Application Under Test Machines.

Входные данные

testMachineGroup - Машины
string. Обязательный.

Разделенный запятыми список полных доменных имен или IP-адресов компьютера, который может содержать номер порта. Максимальное число — 32 компьютера или 32 агента. Элементы списка могут быть следующими:

  • Имя группы ресурсов Azure.
  • Разделенный запятыми список имен компьютеров. Пример: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
  • Выходная переменная из предыдущей задачи.

dropLocation - Тестовое расположение удаления
string. Обязательный.

Указывает расположение на тестовых компьютерах, в которые были скопированы двоичные файлы теста с помощью копирования файлов компьютера Windows или задачи копирования файлов Azure . Для указания расположения удаления можно использовать системные переменные этапа на компьютерах агентов тестирования. Примерами являются события c:\tests и %systemdrive%\Tests.


testSelection - Выбор теста
string. Обязательный. Допустимые значения: testAssembly (тестовая сборка), testPlan (план тестирования). Значение по умолчанию: testAssembly.

Указывает, как выполняются тесты: с помощью тестовых сборок или плана тестирования.


testPlan - План тестирования
string. Требуется, если testSelection = testPlan.

Указывает план тестирования, который уже настроен для этой организации.


testSuite - Набор тестов
string. Требуется, если testSelection = testPlan.

Указывает набор тестов из выбранного плана тестирования.


testConfiguration - Конфигурация тестирования
string. Требуется, если testSelection = testPlan.

Указывает конфигурацию теста из выбранного плана тестирования.


sourcefilters - Тестовая сборка
string. Требуется, если testSelection = testAssembly. Значение по умолчанию: **\*test*.dll.

Указывает двоичные файлы теста для выполнения тестов. Можно использовать подстановочные знаки. Например, для всех .dll файлов, **\*test*.dll; содержащихся test в имени файла.


testFilterCriteria - Критерии тестового фильтра
string. Необязательный элемент. Используйте при testSelection = testAssembly.

Фильтр, который определяет тесты, выполняемые в файлах тестовой сборки. Работает так же, как /TestCaseFilter и параметр в vstest.console.exe. Например, Owner=james&Priority=1.


runSettingsFile - Запуск файла параметров
string.

Указывает путь к файлу runsettings или testsettings для использования с тестами.


overrideRunParams - Переопределение параметров тестового запуска
string.

Задает параметры переопределения, определенные в TestRunParameters разделе runsettings файла или Properties в разделе testsettings файла. Например, AppURL=$(DeployURL);Port=8080.

Примечание

Доступ к свойствам testsettings , указанным в файле, можно получить с помощью TestContext агента тестирования 2017 с обновлением 4 или более поздней версии.


codeCoverageEnabled - Объем протестированного кода включен
boolean. Значение по умолчанию: false.

Указывает, включен ли объем протестированного кода для задачи.


customSlicingEnabled - Распределение тестов по количеству компьютеров
boolean. Значение по умолчанию: false.

Если для этого логического значения задано значение true, тесты распределяются на основе количества предоставленных компьютеров, а не количества тестовых контейнеров.

Примечание

Тесты в .dll могут также распространяться на несколько компьютеров.


testRunTitle - Заголовок тестового запуска
string.

Указывает имя тестового запуска.


platform - Платформы
string.

Указывает платформу, по которой следует сообщать о тестах. Если вы определили переменную для platform в задаче сборки, используйте переменную в качестве значения .


configuration - Конфигурации
string.

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


testConfigurations - Конфигурации тестирования
string.

Необязательный элемент. Связывает фильтр тестовых случаев с идентификатором конфигурации теста. Синтаксис: <Filter1>:<Id1>;DefaultTestConfiguration:<Id3>. Например, FullyQualifiedName~Chrome:12.


autMachineGroup - Тестовые компьютеры приложения
string.

Разделенный запятыми список компьютеров, выходных переменных или имен групп компьютеров, на которых выполняются серверные процессы, например W3WP.exe.


Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Требования

Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент
Требования Нет
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 1.104.0 или более поздней версии
Категория задач Тест