JenkinsQueueJob@2 — zadanie kolejki usługi Jenkins w wersji 2

To zadanie służy do kolejkowania zadania na serwerze Jenkins.

Składnia

# Jenkins queue job v2
# Queue a job on a Jenkins server.
- task: JenkinsQueueJob@2
  inputs:
    serverEndpoint: # string. Required. Jenkins service connection. 
    jobName: # string. Required. Job name. 
    #isMultibranchJob: false # boolean. Job is of multibranch pipeline type. Default: false.
    #multibranchPipelineBranch: # string. Required when isMultibranchJob = true. Multibranch pipeline branch. 
    #captureConsole: true # boolean. Capture console output and wait for completion. Default: true.
    #capturePipeline: true # boolean. Optional. Use when captureConsole = true. Capture pipeline output and wait for pipeline completion. Default: true.
  # Advanced
    #isParameterizedJob: false # boolean. Alias: parameterizedJob. Parameterized job. Default: false.
    #jobParameters: # string. Optional. Use when parameterizedJob = true. Job parameters. 
    #failOnUnstableResult: false # boolean. Fail on unstable result. Default: false.
    #retryCount: '3' # string. Number of retries for failed connection. Default: 3.
    #delayBetweenRetries: '60' # string. Time between retries. Default: 60.

Dane wejściowe

serverEndpoint - Połączenie usługi Jenkins
string. Wymagane.

Określa połączenie usługi dla wystąpienia serwera Jenkins. Kliknij link Zarządzaj, aby utworzyć nowe połączenie usługi Jenkins.

jobName - Nazwa zadania
string. Wymagane.

Nazwa zadania serwera Jenkins do kolejki. Musi to być dokładnie zgodne z nazwą zadania na serwerze Jenkins.

isMultibranchJob - Zadanie jest typu potoku wielobranżowego
boolean. Wartość domyślna: false.

To zadanie jest potokiem wielobranżowym. W przypadku określenia dodaj odpowiednią nazwę gałęzi. Te dane wejściowe wymagają wtyczki serwera Team Foundation Server dla serwera Jenkins w wersji 5.3.4 lub nowszej.

multibranchPipelineBranch - Wielobransowa gałąź potoku
string. Wymagane, gdy isMultibranchJob = true.

Kolejkuje to zadanie potoku wielobranżowego w określonej gałęzi. Te dane wejściowe wymagają wtyczki serwera Team Foundation Server dla serwera Jenkins w wersji 5.3.4 lub nowszej.

captureConsole - Przechwytywanie danych wyjściowych konsoli i oczekiwanie na ukończenie
boolean. Wartość domyślna: true.

Jeśli zostanie określony, te dane wejściowe przechwytują dane wyjściowe konsoli kompilacji narzędzia Jenkins, oczekują na ukończenie kompilacji serwera Jenkins i kończą się powodzeniem/niepowodzeniem na podstawie wyniku kompilacji serwera Jenkins. W przeciwnym razie po kolejkach zadań serwera Jenkins to zadanie zostanie pomyślnie ukończone bez oczekiwania na uruchomienie kompilacji serwera Jenkins.

capturePipeline - Przechwytywanie danych wyjściowych potoku i oczekiwanie na ukończenie potoku
boolean. Opcjonalny. Użyj polecenia , gdy captureConsole = true. Wartość domyślna: true.

Jeśli to zadanie zostanie określone, przechwytuje pełne dane wyjściowe konsoli potoku kompilacji serwera Jenkins, czeka na ukończenie pełnego potoku kompilacji serwera Jenkins i kończy się powodzeniem/niepowodzeniem na podstawie wyniku potoku kompilacji narzędzia Jenkins. W przeciwnym razie po zakończeniu pierwszego zadania serwera Jenkins to zadanie zostanie pomyślnie ukończone bez oczekiwania na uruchomienie pełnego potoku kompilacji serwera Jenkins.

isParameterizedJob - Zadanie sparametryzowane
Alias wejściowy: parameterizedJob. boolean. Wartość domyślna: false.

Określa, czy zadanie narzędzia Jenkins akceptuje parametry. Użyj tych danych wejściowych, nawet jeśli są używane wszystkie domyślne wartości parametrów i nie określono żadnych parametrów.

jobParameters - Parametry zadania
string. Opcjonalny. Użyj polecenia , gdy parameterizedJob = true.

Określa parametry zadania z jednym na wiersz w formacie <parameterName>=<parameterValue>.

Aby ustawić parametr na wartość pustą, która jest przydatna do zastępowania wartości domyślnej, pozostaw wartość parametru. Na przykład określ wartość parameterName=.

Obsługiwane są zmienne. Aby ustawić commitId wartość parametru na identyfikator zatwierdzenia git kompilacji, na przykład można użyć: commitId=$(Build.SourceVersion). Aby uzyskać więcej informacji, zobacz dokumentację dotyczącą zmiennych.

Obsługiwane typy parametrów serwera Jenkins to:

• Boolean
• Choice
• Password
• String

failOnUnstableResult - Niepowodzenie w wyniku niestabilnego
boolean. Wartość domyślna: false.

Określa ścisłość definicji sukcesu lub określa, czy należy rozważyć niestabilność jako błąd, czy nie. Wartość false jest dla wersji nieoostrzejszej, a true wartość jest zgodna z wersją ścisłą. Jeśli ustawiono wartość true, niestabilny wynik kompilacji jest traktowany jako błąd. W przeciwnym razie wynik niestabilny jest traktowany jako sukces.

retryCount - Liczba ponownych prób połączenia zakończonych niepowodzeniem
string. Wartość domyślna: 3.

Określa liczbę ponownych prób połączenia w przypadku wystąpienia błędu lub błędu połączenia.

delayBetweenRetries - Czas między ponawianiami prób
string. Wartość domyślna: 60.

Określa czas między ponawianiem próby połączenia w przypadku wystąpienia błędu. Ta wartość jest określana w sekundach.

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

To zadanie definiuje następujące zmienne wyjściowe, które można używać w krokach podrzędnych, zadaniach i etapach.

JENKINS_JOB_ID
Identyfikator wystąpienia zadania narzędzia Jenkins w kolejce przez to zadanie. Użyj tej zmiennej w zadaniu Pobierania artefaktów serwera Jenkins, aby pobrać artefakty dla tego konkretnego wystąpienia zadania.

Uwagi

To zadanie służy do kolejkowania zadania na serwerze Jenkins.

Wtyczka serwera Team Foundation Server

Możesz użyć wtyczki serwera Team Foundation Server (w wersji 5.2.0 lub nowszej), aby automatycznie zbierać pliki z obszaru roboczego serwera Jenkins i pobierać je do kompilacji.

Aby go skonfigurować:

1. Zainstaluj wtyczkę serwera Team Foundation Server na serwerze Jenkins.

2. Na serwerze Jenkins dla każdego zadania, z którego chcesz zbierać wyniki, dodaj akcję po kompilacji Collect results for Azure Pipelines/TFS (Zbieranie wyników dla usługi Azure Pipelines/TFS ), a następnie skonfiguruj je przy użyciu co najmniej jednej pary typu wyników i dołącz wzorzec pliku.

3. W zadaniu kolejki serwera Jenkins zadanie kompilacji włącz dane wyjściowe konsoli przechwytywania i poczekaj na ukończenie , aby zebrać wyniki z zadania na poziomie głównym, lub dane wyjściowe potoku przechwytywania i poczekać na ukończenie potoku , aby zebrać wyniki ze wszystkich zadań potoku.

Wyniki zostaną pobrane do lokalizacji $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results.zip i wyodrębnione do tej lokalizacji. Każdy zestaw typów wyników zbieranych przez wtyczkę będzie znajdować się w katalogu team-results $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results/ResultType/. Jest to katalog, w którym wyniki kompilacji mogą być publikowane przez podrzędne zadania (na przykład Publikowanie wyników testów i Publikowanie wyników pokrycia kodu).

Wymagania

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