Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 automaticamente testes com falha.
Sintaxe
# 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
máquinas testMachineGroup
-
string
. Obrigatório
Uma lista separada por vírgulas de FQDNs de 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 uma do 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ório
Especifica o local nos computadores de teste em que os binários de teste foram copiados por um de Cópia de Arquivo do Windows Machine Ou uma tarefa cópia de arquivo do Azure. As variáveis de estágio do sistema dos computadores do agente de teste podem ser usadas para especificar o local de descarte. Exemplos: c:\tests
e %systemdrive%\Tests
de Seleção de Teste do testSelection
-
string
. Obrigatório 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.
do Plano de Teste do testPlan
-
string
. Necessário quando testSelection = testPlan
.
Especifica um plano de teste que já está configurado para essa organização.
testSuite
-
do Pacote de Testes
string
. Necessário quando testSelection = testPlan
.
Especifica um conjunto de testes do plano de teste selecionado.
testConfiguration
-
de Configuração de Teste
string
. Necessário quando testSelection = testPlan
.
Especifica uma configuração de teste do plano de teste selecionado.
de assembly de teste do sourcefilters
-
string
. Necessário quando testSelection = testAssembly
. Valor padrão: **\*test*.dll
.
Especifica os binários de teste nos quais executar testes. Curingas podem ser usados. Por exemplo, **\*test*.dll;
para todos os arquivos .dll
que contêm test
no nome do arquivo.
critérios de filtro de teste testFilterCriteria
-
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 de arquivo de configurações
string
.
Especifica o caminho do arquivo para o arquivo runsettings
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 seção TestRunParameters
do arquivo runsettings
ou na seção Properties
do arquivo testsettings
. Exemplo: AppURL=$(DeployURL);Port=8080
.
Observação
As propriedades especificadas no arquivo testsettings
podem ser acessadas por meio de TestContext
usando o Agente de Teste 2017 Atualização 4 ou superior.
cobertura de código codeCoverageEnabled
- 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
Testes em um .dll
também podem ser distribuídos para vários computadores.
testRunTitle
-
de título de 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.
de Configuração do configuration
-
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.
configurações de teste testConfigurations
-
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
.
aplicativo autMachineGroup
- em computadores de teste
string
.
Uma lista separada por vírgulas de computadores, variáveis de saída ou nomes de grupo de máquinas nos quais processos de servidor, como W3WP.exe
, estão em execução.
Opções de controle de tarefa
Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as 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 |
Execuções em | Agente |
de demandas | Nenhum |
recursos | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
restrições de comando | Qualquer |
variáveis settable | Qualquer |
Versão do agente | 1.104.0 ou superior |
Categoria de tarefa | Teste |