DeployVisualStudioTestAgent@2: tarea de implementación del agente de prueba de Visual Studio v2

Importante

Esta tarea está en desuso y se retirará el 31 de enero de 2024. Use la tarea Prueba de Visual Studio para ejecutar pruebas unitarias y funcionales.

Importante

DeployVisualStudioTestAgent@2 está en desuso. Use la tarea Prueba de Visual Studio para ejecutar pruebas unitarias y funcionales.

Syntax

# Visual Studio test agent deployment v2
# DeployVisualStudioTestAgent@2 is deprecated. Use the Visual Studio Test task to run unit and functional tests.
- task: DeployVisualStudioTestAgent@2
  inputs:
  # Test Machines
    testMachines: # string. Required. Machines. 
    adminUserName: # string. Required. Admin login. 
    adminPassword: # string. Required. Admin password. 
    winRmProtocol: 'Http' # 'Http' | 'Https'. Required. Protocol. Default: Http.
    #testCertificate: true # boolean. Optional. Use when winRmProtocol = Https. Test Certificate. Default: true.
  # Agent Configuration
    machineUserName: # string. Required. Username. 
    machinePassword: # string. Required. Password. 
    #runAsProcess: false # boolean. Run UI tests. Default: false.
    #isDataCollectionOnly: false # boolean. Enable data collection only. Default: false.
  # Advanced
    #testPlatform: '14.0' # '15.0' | '14.0'. Test agent version. Default: 14.0.
    #agentLocation: # string. Test agent location. 
    #updateTestAgent: false # boolean. Update test agent. Default: false.
# Visual Studio Test Agent Deployment v2
# DeployVisualStudioTestAgent@2 is deprecated. Use the Visual Studio Test task to run unit and functional tests.
- task: DeployVisualStudioTestAgent@2
  inputs:
  # Test Machines
    testMachines: # string. Required. Machines. 
    adminUserName: # string. Required. Admin login. 
    adminPassword: # string. Required. Admin password. 
    winRmProtocol: 'Http' # 'Http' | 'Https'. Required. Protocol. Default: Http.
    #testCertificate: true # boolean. Optional. Use when winRmProtocol = Https. Test Certificate. Default: true.
  # Agent Configuration
    machineUserName: # string. Required. Username. 
    machinePassword: # string. Required. Password. 
    #runAsProcess: false # boolean. Run UI tests. Default: false.
    #isDataCollectionOnly: false # boolean. Enable data collection only. Default: false.
  # Advanced
    #testPlatform: '14.0' # '15.0' | '14.0'. Test agent version. Default: 14.0.
    #agentLocation: # string. Test agent location. 
    #updateTestAgent: false # boolean. Update test agent. Default: false.

Entradas

testMachines - Máquinas
string. Obligatorio.

Esta entrada tiene tres opciones:

  • Proporciona una lista separada por comas de direcciones IP de máquina o FQDN junto con puertos. El puerto predeterminado se basa en el protocolo seleccionado. Por ejemplo, dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986.
  • Proporciona la variable de salida de otras tareas. Por ejemplo, $(variableName).
  • Proporciona un nombre de grupo de máquinas. Si usa HTTPS, el nombre/IP de la máquina debe coincidir con el CN en el certificado.

adminUserName - inicio de sesión de Administración
string. Obligatorio.

Especifica el inicio de sesión de administrador para las máquinas de destino.


adminPassword - Administración contraseña
string. Obligatorio.

Especifica la contraseña de administrador para las máquinas de destino. Esta entrada puede aceptar una variable definida en definiciones de compilación o versión como $(passwordVariable). Puede marcar el tipo de variable como secret para protegerlo.


winRmProtocol - Protocolo
string. Obligatorio. Valores permitidos: Http, Https. Valor predeterminado: Http.

Especifica el protocolo que se va a usar para la conexión winRM con las máquinas. El valor predeterminado es HTTPS.


testCertificate - Certificado de prueba
boolean. Opcional. Use cuando winRmProtocol = Https. Valor predeterminado: true.

Proporciona la opción de omitir la validación de autenticidad del certificado de la máquina por una entidad de certificación de confianza. El parámetro es necesario para el protocolo HTTPS de WinRM.


machineUserName - Nombre de usuario
string. Obligatorio.

Especifica el nombre de usuario con el que se debe ejecutar el agente de prueba.


machinePassword - Contraseña
string. Obligatorio.

Especifica la contraseña del nombre de usuario especificado anteriormente.


runAsProcess - Ejecución de pruebas de IU
boolean. Valor predeterminado: false.

Indica si el agente de prueba debe ejecutarse como un proceso interactivo. Esta entrada es necesaria para las pruebas automatizadas de IU.


isDataCollectionOnly - Habilitar solo la recopilación de datos
boolean. Valor predeterminado: false.

Opcional. Especifica si el agente de prueba solo se usa para la recopilación de datos y no para ejecutar pruebas. Normalmente, esto se puede encontrar en la aplicación en el grupo de máquinas de prueba (AUT).


testPlatform - Versión del agente de prueba
string. Valores permitidos: 15.0 (Visual Studio 2017), 14.0 (Visual Studio 2015). Valor predeterminado: 14.0.

Especifica la versión del agente de prueba de Visual Studio. Elige una versión adecuada para que coincida con la versión de VS mediante los archivos binarios de prueba que se crearon.


agentLocation - Ubicación del agente de prueba
string.

Opcional. Proporciona la ruta de acceso a vstf_testagent.exe desde la red o la ubicación local. Si no se proporciona ninguna ruta de acceso, se descargará automáticamente desde el centro de descarga. Instale el Agente de pruebas 2015 Update 3.
Instale el Agente de prueba 2017.


updateTestAgent - Actualización del agente de prueba
boolean. Valor predeterminado: false.

Si el Agente de pruebas ya está implementado en un equipo, esta opción comprueba si hay una actualización disponible para esa versión.


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.

Comentarios

Novedades de esta versión de tarea:

  • Compatibilidad con visual Studio Test Agent 2017: ahora puede implementar y ejecutar pruebas con varias versiones del Agente de pruebas de Visual Studio. Se admiten las versiones 2015 y 2017.
  • Los grupos de máquinas creados a partir del centro de pruebas ya no se admiten. Puede seguir usando una lista de máquinas o grupos de recursos de Azure.

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 2.0.0 o superior
Categoría de la tarea: Prueba