RunVisualStudioTestsusingTestAgent@1: tarea Ejecutar pruebas funcionales v1
RunVisualStudioTestsusingTestAgent@1 y su tarea complementaria (implementación del agente de pruebas de Visual Studio) están en desuso. En su lugar, use la tarea Prueba de Visual Studio. La tarea VSTest puede ejecutar pruebas unitarias y funcionales. Ejecute pruebas en uno o varios agentes mediante la configuración de trabajo multiagente. Use la tarea Plataforma de pruebas de Visual Studio para ejecutar pruebas sin necesidad de Visual Studio en el agente. La tarea VSTest también aporta nuevas funcionalidades, como volver a ejecutar automáticamente las pruebas con errores.
Syntax
# 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.
Entradas
testMachineGroup
-
Máquinas
string
. Obligatorio.
Lista separada por comas de FQDN de máquina o direcciones IP, que pueden incluir el número de puerto. El máximo es de 32 máquinas o 32 agentes. Los elementos de lista pueden ser:
- Nombre de un grupo de recursos de Azure.
- Lista delimitada por comas de nombres de máquina. Ejemplo:
dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
- Variable de salida de una tarea anterior.
dropLocation
-
Ubicación de eliminación de pruebas
string
. Obligatorio.
Especifica la ubicación de las máquinas de prueba en las que se han copiado los archivos binarios de prueba mediante una copia de archivos de máquina Windows o una tarea de copia de archivos de Azure . Las variables de fase del sistema de las máquinas del agente de pruebas se pueden usar para especificar la ubicación de destino. Ejemplos: c:\tests
y %systemdrive%\Tests
.
testSelection
-
Selección de prueba
string
. Obligatorio. Valores permitidos: testAssembly
(Ensamblado de prueba), testPlan
(Plan de pruebas). Valor predeterminado: testAssembly
.
Especifica cómo se ejecutan las pruebas: mediante ensamblados de prueba o plan de pruebas.
testPlan
-
Plan de pruebas
string
. Necesario cuando testSelection = testPlan
.
Especifica un plan de prueba que ya está configurado para esta organización.
testSuite
-
Conjunto de pruebas
string
. Necesario cuando testSelection = testPlan
.
Especifica un conjunto de pruebas del plan de pruebas seleccionado.
testConfiguration
-
Configuración de prueba
string
. Necesario cuando testSelection = testPlan
.
Especifica una configuración de prueba del plan de pruebas seleccionado.
sourcefilters
-
Ensamblado de prueba
string
. Necesario cuando testSelection = testAssembly
. Valor predeterminado: **\*test*.dll
.
Especifica los archivos binarios de prueba en los que se ejecutarán las pruebas. Se pueden usar caracteres comodín. Por ejemplo, **\*test*.dll;
para todos los .dll
archivos que contienen test
en el nombre de archivo.
testFilterCriteria
-
Criterios de filtro de prueba
string
. Opcional. Use cuando testSelection = testAssembly
.
Filtro que especifica las pruebas que se van a ejecutar dentro de los archivos de ensamblado de prueba. Funciona de la misma manera que la /TestCaseFilter
opción en vstest.console.exe
. Ejemplo: Owner=james&Priority=1
.
runSettingsFile
-
Archivo de configuración de ejecución
string
.
Especifica la ruta de acceso del archivo al runsettings
archivo o testsettings
que se va a usar con las pruebas.
overrideRunParams
-
Invalidar parámetros de ejecución de pruebas
string
.
Especifica los parámetros de invalidación definidos en la TestRunParameters
sección del runsettings
archivo o la Properties
sección del testsettings
archivo. Ejemplo: AppURL=$(DeployURL);Port=8080
.
Nota:
Se puede acceder a las propiedades especificadas en el testsettings
archivo mediante TestContext
test Agent 2017 Update 4 o posterior.
codeCoverageEnabled
-
Cobertura de código habilitada
boolean
. Valor predeterminado: false
.
Especifica si la cobertura de código está habilitada para la tarea.
customSlicingEnabled
-
Distribución de pruebas por número de máquinas
boolean
. Valor predeterminado: false
.
Cuando el valor de este valor booleano se establece true
en , las pruebas se distribuyen en función del número de máquinas proporcionadas en lugar del número de contenedores de prueba.
Nota
Las pruebas de un .dll
elemento también se pueden distribuir a varias máquinas.
testRunTitle
-
Título de la ejecución de pruebas
string
.
Especifica un nombre para la ejecución de pruebas.
platform
-
Plataforma
string
.
Especifica la plataforma en la que se deben notificar las pruebas. Si ha definido una variable para platform
en la tarea de compilación, use la variable como valor.
configuration
-
Configuración
string
.
Especifica la configuración con la que se deben notificar las pruebas. Si ha definido una variable para configuration
en la tarea de compilación, use la variable como valor.
testConfigurations
-
Configuraciones de prueba
string
.
Opcional. Asocia un filtro de caso de prueba con un identificador de configuración de prueba. Sintaxis: <Filter1>:<Id1>;DefaultTestConfiguration:<Id3>
. Ejemplo: FullyQualifiedName~Chrome:12
.
autMachineGroup
-
Aplicación en máquinas de prueba
string
.
Lista separada por comas de máquinas, variables de salida o nombres de grupo de máquinas en los que se ejecutan procesos de servidor, como W3WP.exe
, .
Opciones de control de tareas
Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.
Variables de salida
Ninguno.
Requisitos
Requisito | Descripción |
---|---|
Tipos de canalización | YAML, compilación clásica, versión clásica |
Se ejecuta en | Agente |
Peticiones | None |
Capabilities | Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo. |
Restricciones de comandos | Any |
Variables que se pueden establecer | Any |
Versión del agente | 1.104.0 o superior |
Categoría de la tarea: | Prueba |