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

Artigo
07/02/2024

Esta tarefa implementa e configura o Agente de Teste para executar testes num conjunto de máquinas.

Importante

Esta tarefa foi preterida. Utilize a tarefa de Teste do Visual Studio para executar testes funcionais e de unidades.

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 - Computadores
string. Obrigatório.

Esta entrada tem três opções:

Fornece uma lista separada por vírgulas de endereços IP ou FQDNs do computador, juntamente com portas. A porta predefinida baseia-se 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 computador. Se estiver a utilizar HTTPS, o nome/IP do computador deve corresponder ao CN no certificado.

adminUserName - Início de Sessão do Administração
string.

Especifica o início de sessão do administrador para os computadores de destino.

adminPassword - palavra-passe do Administração
string.

Especifica a palavra-passe de administrador para os computadores de destino. Esta entrada pode aceitar uma variável definida nas definições de compilação/versão como $(passwordVariable). Pode marcar o tipo de variável como secret para protegê-lo.

winRmProtocol - Protocolo
string. Valores permitidos: Http, Https.

Especifica o protocolo a utilizar para a ligação WinRM com as máquinas virtuais. O valor predefinido é HTTPS.

testCertificate - Testar Certificado
boolean. Opcional. Utilize quando winRmProtocol = Https. Valor predefinido: true.

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

resourceFilteringMethod - Selecionar Máquinas Por
string. Valores permitidos: machineNames (Nomes das Máquinas), tags. Valor predefinido: machineNames.

testMachines - Critérios de Filtro
string.

Fornece uma lista de máquinas como dbserver.fabrikam.com, dbserver_int.fabrikam.com, 192.168.12.34 ou etiquetas como Role:DB;OS:Win8.1. Devolve máquinas virtuais com qualquer uma das etiquetas. Para o Grupo de Recursos do Azure, indique o nome do anfitrião da VM para o nome do computador. A predefinição implementa um agente em todos os computadores representados no campo Máquinas.

machineUserName - Nome de utilizador
string. Obrigatório.

Especifica o nome de utilizador com o qual o agente de teste tem de ser executado.

machinePassword - Palavra-passe
string. Obrigatório.

Especifica a palavra-passe do nome de utilizador indicado acima.

runAsProcess - Processo Interativo
boolean. Valor predefinido: false.

Indica se o agente de teste precisa de ser executado como um processo interativo. Esta entrada é necessária para Testes de IU Codificado.

agentLocation - Localização do Agente de Teste
string.

Opcional. Fornece o caminho para vstf_testagent.exe a partir da rede ou localização local. Se não for fornecido nenhum caminho, será transferido a partir do centro de transferências.

updateTestAgent - Atualizar Agente de Teste
boolean. Valor predefinido: true.

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

isDataCollectionOnly - Ativar Apenas Recolha de Dados
boolean. Valor predefinido: false.

Opcional. Especifica se o agente de teste é utilizado apenas para recolha de dados e não para testes em execução. Normalmente, isto pode ser encontrado na aplicação no grupo de máquinas virtuais de teste (AUT).

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agent, DeploymentGroup
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de definição	Qualquer
Versão do agente	1.104.0 ou superior
Categoria da tarefa	Teste

Partilhar via