Compartilhar via


RunVisualStudioTestsusingTestAgent@1 – Executar testes funcionais v1 tarefa

RunVisualStudioTestsusingTestAgent@1 e sua tarefa complementar (Implantação do Agente de Teste do Visual Studio) foram preteridas. Em vez disso, use a tarefa Teste do Visual Studio. A tarefa VSTest pode executar a unidade, bem como testes funcionais. Execute testes em um ou mais agentes usando a configuração de trabalho de vários agentes. Use a tarefa Plataforma de Teste do Visual Studio para executar testes sem precisar do Visual Studio no agente. A tarefa VSTest também traz novos recursos, como executar novamente testes com falha automaticamente.

Syntax

# Run functional tests v1
# Deprecated: This task and it’s companion task (Visual Studio Test Agent Deployment) are deprecated. Use the 'Visual Studio Test' task instead. The VSTest task can run unit as well as functional tests. Run tests on one or more agents using the multi-agent job setting. Use the 'Visual Studio Test Platform' task to run tests without needing Visual Studio on the agent. VSTest task also brings new capabilities such as automatically rerunning failed tests.
- task: RunVisualStudioTestsusingTestAgent@1
  inputs:
  # Setup Options
    testMachineGroup: # string. Required. Machines. 
    dropLocation: # string. Required. Test Drop Location. 
  # Execution Options
    testSelection: 'testAssembly' # 'testAssembly' | 'testPlan'. Required. Test Selection. Default: testAssembly.
    #testPlan: # string. Required when testSelection = testPlan. Test Plan. 
    #testSuite: # string. Required when testSelection = testPlan. Test Suite. 
    #testConfiguration: # string. Required when testSelection = testPlan. Test Configuration. 
    sourcefilters: '**\*test*.dll' # string. Required when testSelection = testAssembly. Test Assembly. Default: **\*test*.dll.
    #testFilterCriteria: # string. Optional. Use when testSelection = testAssembly. Test Filter criteria. 
    #runSettingsFile: # string. Run Settings File. 
    #overrideRunParams: # string. Override Test Run Parameters. 
    #codeCoverageEnabled: false # boolean. Code Coverage Enabled. Default: false.
    #customSlicingEnabled: false # boolean. Distribute tests by number of machines. Default: false.
  # Reporting Options
    #testRunTitle: # string. Test Run Title. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #testConfigurations: # string. Test Configurations. 
    #autMachineGroup: # string. Application Under Test Machines.
# Run Functional Tests v1
# Deprecated: This task and it’s companion task (Visual Studio Test Agent Deployment) are deprecated. Use the 'Visual Studio Test' task instead. The VSTest task can run unit as well as functional tests. Run tests on one or more agents using the multi-agent job setting. Use the 'Visual Studio Test Platform' task to run tests without needing Visual Studio on the agent. VSTest task also brings new capabilities such as automatically rerunning failed tests.
- task: RunVisualStudioTestsusingTestAgent@1
  inputs:
  # Setup Options
    testMachineGroup: # string. Required. Machines. 
    dropLocation: # string. Required. Test Drop Location. 
  # Execution Options
    testSelection: 'testAssembly' # 'testAssembly' | 'testPlan'. Required. Test Selection. Default: testAssembly.
    #testPlan: # string. Required when testSelection = testPlan. Test Plan. 
    #testSuite: # string. Required when testSelection = testPlan. Test Suite. 
    #testConfiguration: # string. Required when testSelection = testPlan. Test Configuration. 
    sourcefilters: '**\*test*.dll' # string. Required when testSelection = testAssembly. Test Assembly. Default: **\*test*.dll.
    #testFilterCriteria: # string. Optional. Use when testSelection = testAssembly. Test Filter criteria. 
    #runSettingsFile: # string. Run Settings File. 
    #overrideRunParams: # string. Override Test Run Parameters. 
    #codeCoverageEnabled: false # boolean. Code Coverage Enabled. Default: false.
    #customSlicingEnabled: false # boolean. Distribute tests by number of machines. Default: false.
  # Reporting Options
    #testRunTitle: # string. Test Run Title. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #testConfigurations: # string. Test Configurations. 
    #autMachineGroup: # string. Application Under Test Machines.

Entradas

testMachineGroup - Máquinas
string. Obrigatórios.

Uma lista separada por vírgulas de FQDNs do computador ou endereços IP, que pode incluir o número da porta. O máximo é de 32 computadores ou 32 agentes. Os itens de lista podem ser:

  • O nome de um Grupo de Recursos do Azure.
  • Uma lista delimitada por vírgulas de nomes de computador. Exemplo: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
  • Uma variável de saída de uma tarefa anterior.

dropLocation - Local de descarte de teste
string. Obrigatórios.

Especifica o local nos computadores de teste em que os binários de teste foram copiados por uma cópia de arquivo do Windows Machine ou uma tarefa de Cópia de Arquivo do Azure . As variáveis de preparação do sistema dos computadores do agente de teste podem ser usadas para especificar o local de destino. Exemplos: c:\tests e %systemdrive%\Tests.


testSelection - Seleção de Teste
string. Obrigatórios. Valores permitidos: testAssembly (Assembly de Teste) testPlan (Plano de Teste). Valor padrão: testAssembly.

Especifica como os testes são executados: usando assemblies de teste ou Plano de Teste.


testPlan - Plano de Teste
string. Obrigatório quando testSelection = testPlan.

Especifica um plano de teste que já está configurado para esta organização.


testSuite - Pacote de Testes
string. Obrigatório quando testSelection = testPlan.

Especifica um pacote de testes do plano de teste selecionado.


testConfiguration - Configuração de teste
string. Obrigatório quando testSelection = testPlan.

Especifica uma configuração de teste do plano de teste selecionado.


sourcefilters - Assembly de teste
string. Obrigatório quando testSelection = testAssembly. Valor padrão: **\*test*.dll.

Especifica os binários de teste nos quais executar testes. Caracteres curinga podem ser usados. Por exemplo, **\*test*.dll; para todos os .dll arquivos que contêm test o nome do arquivo.


testFilterCriteria - Critérios de filtro de teste
string. Opcional. Use quando testSelection = testAssembly.

O filtro que especifica os testes a serem executados nos arquivos de assembly de teste. Funciona da mesma maneira que a opção /TestCaseFilter em vstest.console.exe. Exemplo: Owner=james&Priority=1.


runSettingsFile - Executar arquivo de configurações
string.

Especifica o caminho do arquivo para o runsettings arquivo ou testsettings a ser usado com os testes.


overrideRunParams - Substituir parâmetros de execução de teste
string.

Especifica os parâmetros de substituição definidos na TestRunParameters seção do runsettings arquivo ou na Properties seção do testsettings arquivo. Exemplo: AppURL=$(DeployURL);Port=8080.

Observação

As propriedades especificadas no arquivo podem ser acessadas por meio TestContext do testsettings uso da Atualização 4 ou superior do Agente de Teste 2017.


codeCoverageEnabled - Cobertura de código habilitada
boolean. Valor padrão: false.

Especifica se a Cobertura de Código está habilitada para a tarefa.


customSlicingEnabled - Distribuir testes por número de computadores
boolean. Valor padrão: false.

Quando o valor desse booliano é definido como true, os testes são distribuídos com base no número de computadores fornecidos em vez do número de contêineres de teste.

Observação

Os testes em um .dll também podem ser distribuídos para vários computadores.


testRunTitle - Título da Execução de Teste
string.

Especifica um nome para a execução do teste.


platform - Plataforma
string.

Especifica a plataforma na qual os testes devem ser relatados. Se você definiu uma variável para platform em sua tarefa de build, use a variável como o valor .


configuration - Configuração
string.

Especifica a configuração na qual os testes devem ser relatados. Se você definiu uma variável para configuration em sua tarefa de build, use a variável como o valor .


testConfigurations - Configurações de teste
string.

Opcional. Associa um filtro de caso de teste a uma ID de configuração de teste. Sintaxe: <Filter1>:<Id1>;DefaultTestConfiguration:<Id3>. Exemplo: FullyQualifiedName~Chrome:12.


autMachineGroup - Aplicativo em Computadores de Teste
string.

Uma lista separada por vírgulas de computadores, variáveis de saída ou nomes de grupo de computadores nos quais os processos do servidor, como W3WP.exe, estão em execuçã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.

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