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

Importante

Esta tarefa foi preterida e será descontinuada a 31 de janeiro de 2024. Utilize a tarefa de Teste do Visual Studio para executar testes funcionais e de unidades.

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.

Entradas

testMachines - 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 Administração
string. Obrigatório.

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

adminPassword - Administração palavra-passe
string. Obrigatório.

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. Obrigatório. Valores permitidos: Http, Https. Valor predefinido: Http.

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.

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 - Executar testes de IU
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.

isDataCollectionOnly - Ativar apenas a 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).

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

Especifica a versão do agente de teste do Visual Studio. Escolhe uma versão adequada para corresponder à versão do VS com 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 localização local. Se não for fornecido nenhum caminho, será transferido automaticamente a partir do centro de transferências. Instale o Test Agent 2015 Update 3.
Instale o Test Agent 2017.

updateTestAgent - Atualizar agente de teste
boolean. Valor predefinido: false.

Se o Agente de Teste já estiver implementado num computador, esta opção verifica se está disponível uma atualização para essa versão.

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.

Observações

Novidades nesta versão de tarefa:

• Suporte para o Visual Studio Test Agent 2017: agora pode implementar e executar testes com várias versões do Agente de Teste do Visual Studio. As versões 2015 e 2017 são suportadas.
• Os grupos de máquinas criados a partir do hub de teste já não são suportados. Pode continuar a utilizar uma lista de computadores ou grupos de recursos do Azure.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agente
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	2.0.0 ou superior
Categoria da tarefa	Teste