DeployVisualStudioTestAgent@2 – Tarefa v2 de implantação do agente de teste do Visual Studio

Importante

Essa tarefa foi preterida e será desativada em 31 de janeiro de 2024. Use a tarefa Teste do Visual Studio para executar testes funcionais e de unidade.

Importante

DeployVisualStudioTestAgent@2 foi preterido. Use a tarefa Teste do Visual Studio para executar testes funcionais e de unidade.

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. Obrigatórios.

Essa entrada tem três opções:

  • Fornece uma lista separada por vírgulas de endereços IP do computador ou FQDNs junto com portas. A porta padrão é baseada no protocolo selecionado. Por exemplo, dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986.
  • Fornece a variável de saída de outras tarefas. Por exemplo, $(variableName).
  • Fornece um nome de grupo de computadores. Se você estiver usando HTTPS, o nome/IP do computador deverá corresponder ao CN no certificado.

adminUserName - logon Administração
string. Obrigatórios.

Especifica o logon do administrador para os computadores de destino.


adminPassword - Administração senha
string. Obrigatórios.

Especifica a senha de administrador para os computadores de destino. Essa entrada pode aceitar uma variável definida em definições de build/versão como $(passwordVariable). Você pode marcar o tipo de variável como secret para protegê-lo.


winRmProtocol - Protocolo
string. Obrigatórios. Valores Permitidos: Http e Https. Valor padrão: Http.

Especifica o protocolo a ser usado para a conexão WinRM com os computadores. O valor padrão é HTTPS.


testCertificate - Testar certificado
boolean. Opcional. Use quando winRmProtocol = Https. Valor padrão: true.

Fornece a opção de ignorar a validação de autenticidade do certificado do computador por uma autoridade de certificação confiável. O parâmetro é necessário para o protocolo HTTPS do WinRM.


machineUserName - Username
string. Obrigatórios.

Especifica o nome de usuário com o qual o agente de teste precisa ser executado.


machinePassword - Senha
string. Obrigatórios.

Especifica a senha para o nome de usuário especificado acima.


runAsProcess - Executar testes de interface do usuário
boolean. Valor padrão: false.

Indica se o agente de teste precisa ser executado como um processo interativo. Essa entrada é necessária para testes de interface do usuário codificados.


isDataCollectionOnly - Habilitar somente a coleta de dados
boolean. Valor padrão: false.

Opcional. Especifica se o agente de teste é usado apenas para coleta de dados e não para execução de testes. Normalmente, isso pode ser encontrado no aplicativo no grupo de computadores de teste (AUT).


testPlatform - Versão do agente de teste
string. Valores permitidos: 15.0 (Visual Studio 2017) 14.0 (Visual Studio 2015). Valor padrão: 14.0.

Especifica a versão do agente de teste do Visual Studio. Escolhe uma versão apropriada para corresponder à versão do VS usando os binários de teste que foram criados.


agentLocation - Local do agente de teste
string.

Opcional. Fornece o caminho para vstf_testagent.exe da rede ou local. Se nenhum caminho for fornecido, ele será baixado automaticamente do centro de download. Instale o Agente de Teste 2015 Atualização 3.
Instalar o Agente de Teste 2017.


updateTestAgent - Atualizar agente de teste
boolean. Valor padrão: false.

Se o Agente de Teste já estiver implantado em um computador, essa opção verificará se uma atualização está disponível para essa versão.


Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Novidades nesta versão da tarefa:

  • Suporte para o Visual Studio Test Agent 2017: agora você pode implantar e executar testes usando várias versões do Agente de Teste do Visual Studio. Há suporte para as versões 2015 e 2017.
  • Não há mais suporte para grupos de computadores criados a partir do hub de teste. Você pode continuar a usar uma lista de computadores ou grupos de recursos do Azure.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
É executado em Agente
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.0.0 ou superior
Categoria da tarefa Teste