DeployVisualStudioTestAgent@1 – Tarefa de Implantação v1 do Agente de Teste do Visual Studio

Artigo
07/02/2024

Essa tarefa implanta e configura o Agente de Teste para executar testes em um conjunto de computadores.

Importante

Essa tarefa foi preterida. Use a tarefa Teste do Visual Studio para executar testes funcionais e de unidade.

Syntax

# Visual Studio Test Agent Deployment v1
# Deploy and configure Test Agent to run tests on a set of machines.
- task: DeployVisualStudioTestAgent@1
  inputs:
  # Test Machine Group
    testMachineGroup: # string. Required. Machines. 
    #adminUserName: # string. Admin Login. 
    #adminPassword: # string. Admin Password. 
    #winRmProtocol: # 'Http' | 'Https'. Protocol. 
    #testCertificate: true # boolean. Optional. Use when winRmProtocol = Https. Test Certificate. Default: true.
    #resourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #testMachines: # string. Filter Criteria. 
  # Agent Configuration
    machineUserName: # string. Required. Username. 
    machinePassword: # string. Required. Password. 
    #runAsProcess: false # boolean. Interactive Process. Default: false.
  # Advanced
    #agentLocation: # string. Test Agent Location. 
    #updateTestAgent: true # boolean. Update Test Agent. Default: true.
    #isDataCollectionOnly: false # boolean. Enable Data Collection Only. Default: false.

Entradas

testMachineGroup - 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 de administrador
string.

Especifica o logon do administrador para os computadores de destino.

adminPassword - Senha Administração
string.

Especifica a senha do 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. Valores Permitidos: Http e Https.

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.

resourceFilteringMethod - Selecionar computadores por
string. Valores permitidos: machineNames (Nomes de Máquina), tags. Valor padrão: machineNames.

testMachines - Critérios de Filtro
string.

Fornece uma lista de computadores como dbserver.fabrikam.com, dbserver_int.fabrikam.com, 192.168.12.34 ou marcas como Role:DB;OS:Win8.1. Retorna computadores que têm uma das marcas. Para o Grupo de Recursos do Azure, forneça o nome do host da VM para o nome do computador. O padrão implanta um agente em todos os computadores representados no campo Computadores.

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 - Processo Interativo
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 IU codificados.

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 do centro de download.

updateTestAgent - Atualizar o Agente de Teste
boolean. Valor padrão: true.

Opcional. Especifica se o agente de teste precisa ser atualizado.

isDataCollectionOnly - Habilitar Somente 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. Normalmente, isso pode ser encontrado no aplicativo no grupo de computadores de teste (AUT).

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.

Requisitos

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

Compartilhar via