JenkinsQueueJob@1 — zadanie kolejki serwera Jenkins w wersji 1
To zadanie służy do kolejkowania zadania na serwerze Jenkins.
Składnia
# Jenkins Queue Job v1
# Queue a job on a Jenkins server.
- task: JenkinsQueueJob@1
inputs:
serverEndpoint: # string. Required. Jenkins service endpoint.
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
#parameterizedJob: false # boolean. Parameterized job. Default: false.
#jobParameters: # string. Optional. Use when parameterizedJob = true. Job parameters.
Dane wejściowe
serverEndpoint
-
punktu końcowego usługi Jenkins
string
. To jest wymagane.
Określa punkt końcowy usługi dla wystąpienia serwera Jenkins. Kliknij link Zarządzaj (w przypadku korzystania z asystenta zadań), aby utworzyć nowy punkt końcowy 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 ten krok zostanie pomyślnie ukończony 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, te dane wejściowe przechwytują pełne dane wyjściowe konsoli potoku kompilacji serwera Jenkins, oczekują na ukończenie pełnego potoku kompilacji serwera Jenkins i kończą się powodzeniem/niepowodzeniem na podstawie wyniku potoku kompilacji serwera Jenkins. W przeciwnym razie po zakończeniu pierwszego zadania serwera Jenkins dane wejściowe zostały pomyślnie zakończone bez oczekiwania na uruchomienie pełnego potoku kompilacji serwera Jenkins.
zadania sparametryzowanego 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, na przykład: <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
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
Żaden.
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 | Wszystkie obsługiwane wersje agentów. |
Kategoria zadań | Zbuduj |