RunVisualStudioTestsusingTestAgent@1 – spuštění úlohy funkčních testů v1

RunVisualStudioTestsusingTestAgent@1 a jeho doprovodná úloha (nasazení agenta Visual Studio Test Agent) jsou zastaralé. Místo toho použijte úlohu Visual Studio Test. Úloha VSTest může spouštět testy jednotek i funkční testy. Spusťte testy na jednom nebo více agentech pomocí nastavení úlohy s více agenty. Pomocí úlohy Testovací platforma sady Visual Studio můžete spouštět testy bez nutnosti sady Visual Studio v agentech. Úloha VSTest přináší také nové funkce, jako je automatické opětovné spuštění neúspěšných testů.

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.

Vstupy

testMachineGroup - Stroje
string. Povinná hodnota.

Čárkami oddělený seznam plně kvalifikovaných názvů domén nebo IP adres počítače, který může obsahovat číslo portu. Maximální počet je 32 počítačů nebo 32 agentů. Položky seznamu můžou být:

  • Název skupiny prostředků Azure.
  • Seznam názvů počítačů oddělených čárkami. Příklad: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
  • Výstupní proměnná z předchozího úkolu.

dropLocation - Umístění vyřazení testu
string. Povinná hodnota.

Určuje umístění na testovacích počítačích, kam byly testovací binární soubory zkopírovány úlohou Kopírování souborů počítače s Windows nebo Kopírování souborů Azure . Proměnné systémové fáze z počítačů testovacího agenta je možné použít k určení umístění vyřazení. Příklady: c:\tests a %systemdrive%\Tests.


testSelection - Výběr testu
string. Povinná hodnota. Povolené hodnoty: testAssembly (Testovací sestavení), testPlan (Testovací plán). Výchozí hodnota: testAssembly.

Určuje způsob spouštění testů: pomocí testovacích sestavení nebo testovacího plánu.


testPlan - Testovací plán
string. Vyžaduje se, když testSelection = testPlan.

Určuje testovací plán, který je již pro tuto organizaci nakonfigurovaný.


testSuite - Testovací sada
string. Vyžaduje se, když testSelection = testPlan.

Určuje sadu testů z vybraného testovacího plánu.


testConfiguration - Konfigurace testu
string. Vyžaduje se, když testSelection = testPlan.

Určuje konfiguraci testu z vybraného testovacího plánu.


sourcefilters - Testovací sestavení
string. Vyžaduje se, když testSelection = testAssembly. Výchozí hodnota: **\*test*.dll.

Určuje binární soubory testů, na kterých se mají testy spouštět. Je možné použít zástupné é kóty. Například **\*test*.dll; pro všechny .dll soubory, které obsahují test v názvu souboru.


testFilterCriteria - Kritéria testovacího filtru
string. Nepovinný parametr. Použijte, když testSelection = testAssembly.

Filtr, který specifikuje testy, které se mají provést v souborech sestavení testu. Funguje stejně jako možnost v vstest.console.exenástroji /TestCaseFilter . Příklad: Owner=james&Priority=1.


runSettingsFile - Spustit soubor nastavení
string.

Určuje cestu k runsettings souboru nebo testsettings souboru, který se má použít s testy.


overrideRunParams - Přepsání parametrů testovacího běhu
string.

Určuje parametry přepsání, které jsou definovány v TestRunParameters oddílu runsettings souboru nebo Properties v oddílu testsettings souboru. Příklad: AppURL=$(DeployURL);Port=8080.

Poznámka

K vlastnostem zadaným testsettings v souboru je možné získat přístup pomocí TestContext testovacího agenta 2017 Update 4 nebo vyšší.


codeCoverageEnabled - Pokrytí kódu povoleno
boolean. Výchozí hodnota: false.

Určuje, jestli je pro úlohu povolené pokrytí kódu.


customSlicingEnabled - Distribuce testů podle počtu počítačů
boolean. Výchozí hodnota: false.

Pokud je hodnota této logické hodnoty nastavena na truehodnotu , testy se distribuují na základě počtu počítačů, které jsou k dispozici, a nikoli na základě počtu testovacích kontejnerů.

Poznámka

Testy v rámci objektu .dll mohou být také distribuovány do více počítačů.


testRunTitle - Název testovacího běhu
string.

Určuje název testovacího běhu.


platform - Platforma
string.

Určuje platformu, proti které se mají hlásit testy. Pokud jste v úloze sestavení definovali proměnnou pro platform , použijte proměnnou jako hodnotu .


configuration - Konfigurace
string.

Určuje konfiguraci, proti které mají být testy hlášeny. Pokud jste v úloze sestavení definovali proměnnou pro configuration , použijte proměnnou jako hodnotu .


testConfigurations - Konfigurace testů
string.

Nepovinný parametr. Přidruží filtr testovacího případu k ID konfigurace testu. Syntaxe: <Filter1>:<Id1>;DefaultTestConfiguration:<Id3>. Příklad: FullyQualifiedName~Chrome:12.


autMachineGroup - Aplikace v testovacích počítačích
string.

Čárkami oddělený seznam počítačů, výstupních proměnných nebo názvů skupin počítačů, na kterých běží serverové procesy, například W3WP.exe.


Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Požadavky

Požadavek Popis
Typy kanálů YAML, klasický build, klasická verze
Běží na Agent
Požadavky Žádné
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta 1.104.0 nebo vyšší
Kategorie úloh Test