RunVisualStudioTestsusingTestAgent@1 — uruchamianie zadań testów funkcjonalnych w wersji 1

RunVisualStudioTestsusingTestAgent@1 i jego zadanie towarzyszące (wdrożenie agenta testowego programu Visual Studio) są przestarzałe. Zamiast tego użyj zadania Test programu Visual Studio. Zadanie VSTest może uruchamiać jednostkę, a także testy funkcjonalne. Uruchamianie testów na co najmniej jednym agencie przy użyciu ustawienia zadania obejmującego wiele agentów. Użyj zadania Platforma testowa programu Visual Studio, aby uruchamiać testy bez konieczności używania programu Visual Studio na agencie. Zadanie VSTest oferuje również nowe możliwości, takie jak automatyczne ponowne uruchamianie testów zakończone niepowodzeniem.

Składnia

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

Dane wejściowe

testMachineGroup - Maszyny
string. Wymagane.

Rozdzielona przecinkami lista nazw FQDN maszyny lub adresów IP, które mogą zawierać numer portu. Maksymalna liczba to 32 maszyn lub 32 agentów. Elementy listy mogą być następujące:

• Nazwa grupy zasobów platformy Azure.
• Rozdzielana przecinkami lista nazw maszyn. Przykład: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
• Zmienna wyjściowa z poprzedniego zadania.

dropLocation - Lokalizacja upuszczania testu
string. Wymagane.

Określa lokalizację na maszynach testowych, na których pliki binarne testów zostały skopiowane przez kopię pliku komputera z systemem Windows lub zadanie kopiowania plików platformy Azure . Zmienne etapu systemu z maszyn agenta testowego mogą służyć do określania lokalizacji upuszczania. Przykłady: c:\tests i %systemdrive%\Tests.

testSelection - Wybór testu
string. Wymagane. Dozwolone wartości: testAssembly (Test Assembly), testPlan (Plan testu). Wartość domyślna: testAssembly.

Określa sposób uruchamiania testów: przy użyciu zestawów testowych lub planu testów.

testPlan - Plan testu
string. Wymagane, gdy testSelection = testPlan.

Określa plan testu, który jest już skonfigurowany dla tej organizacji.

testSuite - Zestaw testów
string. Wymagane, gdy testSelection = testPlan.

Określa zestaw testów z wybranego planu testu.

testConfiguration - Konfiguracja testu
string. Wymagane, gdy testSelection = testPlan.

Określa konfigurację testu z wybranego planu testu.

sourcefilters - Zestaw testowy
string. Wymagane, gdy testSelection = testAssembly. Wartość domyślna: **\*test*.dll.

Określa pliki binarne testów do uruchamiania testów. Można używać symboli wieloznacznych. Na przykład **\*test*.dll; dla wszystkich .dll plików zawierających test nazwę pliku.

testFilterCriteria - Kryteria filtru testowego
string. Opcjonalny. Użyj polecenia , gdy testSelection = testAssembly.

Filtr określający testy do wykonania w plikach zestawu testowego. Działa tak samo jak /TestCaseFilter w przypadku opcji w pliku vstest.console.exe. Przykład: Owner=james&Priority=1.

runSettingsFile - Uruchom plik ustawień
string.

Określa ścieżkę pliku do runsettings pliku lub testsettings do użycia z testami.

overrideRunParams - Zastąpij parametry przebiegu testu
string.

Określa parametry przesłonięcia zdefiniowane w TestRunParameters sekcji runsettings pliku lub Properties sekcji testsettings pliku. Przykład: AppURL=$(DeployURL);Port=8080.

Uwaga

Dostęp do właściwości określonych w testsettings pliku można uzyskać za pomocą TestContext agenta testowego 2017 Update 4 lub nowszego.

codeCoverageEnabled - Włączono pokrycie kodu
boolean. Wartość domyślna: false.

Określa, czy pokrycie kodu jest włączone dla zadania.

customSlicingEnabled - Dystrybuowanie testów według liczby maszyn
boolean. Wartość domyślna: false.

Gdy wartość tej wartości logicznej jest ustawiona na truewartość , testy są dystrybuowane na podstawie liczby dostarczonych maszyn zamiast liczby kontenerów testowych.

Uwaga

Testy w obiekcie .dll mogą być również dystrybuowane do wielu maszyn.

testRunTitle - Tytuł przebiegu testu
string.

Określa nazwę przebiegu testu.

platform - Platformy
string.

Określa platformę, względem której należy zgłaszać testy. Jeśli zdefiniowano zmienną dla platform elementu w zadaniu kompilacji, użyj zmiennej jako wartości.

configuration - Konfiguracji
string.

Określa konfigurację, względem której należy zgłaszać testy. Jeśli zdefiniowano zmienną dla configuration elementu w zadaniu kompilacji, użyj zmiennej jako wartości.

testConfigurations - Konfiguracje testów
string.

Opcjonalny. Kojarzy filtr przypadku testowego z identyfikatorem konfiguracji testu. Składnia: <Filter1>:<Id1>;DefaultTestConfiguration:<Id3>. Przykład: FullyQualifiedName~Chrome:12.

autMachineGroup - Maszyny testowe aplikacji
string.

Rozdzielona przecinkami lista maszyn, zmiennych wyjściowych lub nazw grup maszyn, na których działają procesy serwera, takie jak W3WP.exe, .

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa w	Agent
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	1.104.0 lub nowsza
Kategoria zadania	Testowanie