RunVisualStudioTestsusingTestAgent@1 - 运行功能测试 v1 任务

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.

输入

testMachineGroup - 计算机
string。 必填。

计算机 FQDN 或 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 - 测试计划
stringtestSelection = testPlan时是必需的。

指定已为此组织配置的测试计划。


testSuite - Test Suite
stringtestSelection = testPlan时是必需的。

指定所选测试计划中的测试套件。


testConfiguration - 测试配置
stringtestSelection = testPlan时是必需的。

指定所选测试计划中的测试配置。


sourcefilters - 测试程序集
stringtestSelection = testAssembly时是必需的。 默认值:**\*test*.dll

指定要运行测试的测试二进制文件。 可以使用通配符。 例如,对于文件名中包含 test 的所有 .dll 文件,**\*test*.dll;


testFilterCriteria - 测试筛选器条件
string。 可选。 当 testSelection = testAssembly时使用。

用于指定测试在测试程序集文件中执行的测试的筛选器。 的工作方式与 vstest.console.exe中的 /TestCaseFilter 选项相同。 示例:Owner=james&Priority=1


runSettingsFile - 运行设置文件
string

指定要用于测试的 runsettingstestsettings 文件的文件路径。


overrideRunParams - 替代测试运行参数
string

指定在 runsettings 文件的 TestRunParameters 节或 testsettings 文件的 Properties 节中定义的替代参数。 示例:AppURL=$(DeployURL);Port=8080

注释

可以使用测试代理 2017 Update 4 或更高版本通过 TestContext 访问 testsettings 文件中指定的属性。


已启用 codeCoverageEnabled - 代码覆盖率
boolean。 默认值:false

指定是否为任务启用代码覆盖率。


customSlicingEnabled - 按计算机数分配测试
boolean。 默认值:false

当此布尔值设置为 true时,测试将基于提供的计算机数而不是测试容器数进行分布。

注释

.dll 中的测试也可能分发到多台计算机。


testRunTitle - 测试运行游戏
string

指定测试运行的名称。


platform - 平台
string

指定应对其报告测试的平台。 如果在生成任务中为 platform 定义了变量,请使用变量作为值。


configuration - 配置
string

指定应对其报告测试的配置。 如果在生成任务中为 configuration 定义了变量,请使用变量作为值。


testConfigurations - 测试配置
string

可选。 将测试用例筛选器与测试配置 ID 相关联。 语法:<Filter1>:<Id1>;DefaultTestConfiguration:<Id3>。 示例:FullyQualifiedName~Chrome:12


在测试计算机autMachineGroup - 应用程序
string

运行服务器进程(如 W3WP.exe)的计算机、输出变量或计算机组名称的逗号分隔列表。


任务控制选项

除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性

输出变量

没有。

要求

要求 说明
管道类型 YAML,经典版本,经典版本
运行时间 代理人
需求 没有
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任何
Settable 变量 任何
代理版本 1.104.0 或更高版本
任务类别 测试