Partilhar via


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

Importante

Esta tarefa foi preterida e será desativada em 31 de janeiro de 2024. Use o de tarefas de teste do Visual Studio para executar testes funcionais e de unidade.

Importante

DeployVisualStudioTestAgent@2 foi preterido. Use o de tarefas de teste do Visual Studio para executar testes funcionais e de unidade.

Sintaxe

# 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.

Insumos

testMachines - Máquinas
string. Obrigatório.

Esta entrada tem três opções:

  • Fornece uma lista separada por vírgulas de endereços IP da máquina ou FQDNs, juntamente 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 máquinas. Se você estiver usando HTTPS, o nome/IP da máquina deve corresponder ao CN no certificado.

adminUserName - de login de administrador
string. Obrigatório.

Especifica o login de administrador para as máquinas de destino.


adminPassword - Senha de administrador
string. Obrigatório.

Especifica a senha de administrador para as máquinas de destino. Esta entrada pode aceitar uma variável definida nas definições de compilação/versão como $(passwordVariable). Você pode marcar o tipo de variável como secret para protegê-la.


winRmProtocol - Protocolo
string. Obrigatório. Valores permitidos: Http, Https. Valor padrão: Http.

Especifica o protocolo a ser usado para a conexão do WinRM com a(s) máquina(s). O valor predefinido é HTTPS.


testCertificate - Certificado de Teste
boolean. Opcional. Use quando winRmProtocol = Https. Valor padrão: true.

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


machineUserName - Nome de utilizador
string. Obrigatório.

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


machinePassword - Palavra-passe
string. Obrigatório.

Especifica a senha para o nome de usuário fornecido 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 executar testes. Isso normalmente pode ser encontrado no aplicativo sob o grupo de máquinas 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 VS usando os binários de teste que foram criados.


agentLocation - Localização do agente de teste
string.

Opcional. Fornece o caminho para vstf_testagent.exe a partir da rede ou do local local. Se nenhum caminho for fornecido, ele será baixado automaticamente do centro de download . Instale o Test Agent 2015 Update 3.
Instalar o Test Agent 2017.


updateTestAgent - Agente de teste de atualização
boolean. Valor padrão: false.

Se o Test Agent já estiver implantado em uma máquina, essa opção verificará se uma atualização está disponível para essa versão.


Opções de controlo de tarefas

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

Variáveis de saída

Nenhum.

Observações

O que há de novo nesta versão da tarefa:

  • Suporte para Visual Studio Test Agent 2017: Agora você pode implantar e executar testes usando várias versões do Visual Studio Test Agent. As versões 2015 e 2017 são suportadas.
  • Os grupos de máquinas criados a partir do hub de teste não são mais suportados. Você pode continuar a usar uma lista de máquinas ou grupos de recursos do Azure.

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.0.0 ou superior
Categoria de tarefa Teste