JenkinsQueueJob@1 — zadanie kolejki usługi 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
- Punkt końcowy usługi Jenkins
string
. Wymagane.
Określa punkt końcowy usługi dla wystąpienia serwera Jenkins. Kliknij link Zarządzaj (w przypadku używania asystent zadania), aby utworzyć nowy punkt końcowy 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 ten krok zostanie ukończony pomyślnie 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 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 narzędzia Jenkins. W przeciwnym razie po zakończeniu pierwszego zadania serwera Jenkins to dane wejściowe zostały pomyślnie ukończone bez oczekiwania na uruchomienie pełnego potoku kompilacji serwera Jenkins.
parameterizedJob
- Zadanie sparametryzowane
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, 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ć 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
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, 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 | Wszystkie obsługiwane wersje agenta. |
Kategoria zadania | Kompilacja |