Udostępnij za pośrednictwem


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