JenkinsQueueJob@2 — zadanie kolejki serwera 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łączenia usługi Jenkins
string. To jest 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. To jest wymagane.

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

zadanie isMultibranchJob - 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 - wielobranżowa 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 - przechwytywania danych wyjściowych konsoli i poczekaj 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 narzędzia Jenkins i kończą się powodzeniem/niepowodzeniem na podstawie wyniku kompilacji narzędzia Jenkins. W przeciwnym razie po kolejkach zadań serwera Jenkins to zadanie zostanie pomyślnie zakończone bez oczekiwania na uruchomienie kompilacji serwera Jenkins.

capturePipeline - przechwyć dane wyjściowe potoku i poczekaj na ukończenie potoku
boolean. Opcjonalny. Użyj polecenia , gdy captureConsole = true. Wartość domyślna: true.

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

zadania sparametryzowanego isParameterizedJob -
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.

parametrów zadania jobParameters -
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ć wartość parametru commitId na identyfikator zatwierdzenia git kompilacji, można na przykład 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 niestabilnym wyniku
boolean. Wartość domyślna: false.

Określa ścisłość definicji powodzenia lub czy należy rozważyć niestabilność jako awarię, czy nie. Wartość false dotyczy wersji innej niż ścisła, a true jest zgodna ze ścisłą wersją. Jeśli ustawiono wartość true, wynik niestabilnej kompilacji jest traktowany jako błąd. W przeciwnym razie niestabilny wynik jest traktowany jako sukces.

retryCount - liczba ponownych prób dla nieudanego połączenia
string. Wartość domyślna: 3.

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

delayBetweenRetries - czas między ponowną próbą
string. Wartość domyślna: 60.

Określa czas między ponownymi próbami połączenia, gdy wystąpi błąd. Ta wartość jest określona w sekundach.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli 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 Jenkins Download Artifacts, 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 Zbieraj wyniki dla usługi Azure Pipelines/TFS akcji po kompilacji, a następnie skonfiguruj je przy użyciu co najmniej jednej pary typu wyniku 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 zebrać wyniki z zadania poziomu głównego lub dane wyjściowe potoku przechwytywania i poczekać na ukończenie potoku zebrać wyniki ze wszystkich zadań potoku.

Wyniki zostaną pobrane do $(Build.StagingDirectory)/jenkinsResults/Nazwa zadania/team-results.zip i wyodrębnione do tej lokalizacji. Każdy zestaw typów wyników zebranych przez wtyczkę będzie znajdować się w katalogu team-results, $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results/ResultType/. Jest to katalog, w którym można publikować wyniki kompilacji za pomocą podrzędnych zadań (na przykład opublikować wyniki testu i opublikować wyniki pokrycia kodu).

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Żaden
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	2.144.0 lub nowsza
Kategoria zadań	Zbuduj