JenkinsQueueJob@1 – Jenkins-köjobb v1-aktivitet

Artikel
02/24/2025

Använd den här uppgiften för att köa ett jobb på en Jenkins-server.

Syntax

# 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.

Indata

serverEndpoint - Jenkins-tjänstslutpunkt
string. Krävs.

Anger tjänstslutpunkten för Jenkins-instansen. Klicka på länken Hantera (när du använder uppgiften assistent) för att skapa en ny Jenkins-tjänstslutpunkt.

jobName - Jobbnamn
string. Krävs.

Namnet på Jenkins-jobbet som ska köas. Detta måste exakt matcha jobbnamnet på Jenkins-servern.

isMultibranchJob - Jobbet är av typen Multibranch-pipeline
boolean. Standardvärde: false.

Det här jobbet är en pipeline för flera slipningar. Om du anger det lägger du till lämpligt grennamn. Indata kräver Plugin-programmet Team Foundation Server för Jenkins v5.3.4 eller senare.

multibranchPipelineBranch - Gren för flerslangspipeline
string. Krävs när isMultibranchJob = true.

Köar det här pipelinejobbet för multibranch på den angivna grenen. Indata kräver Plugin-programmet Team Foundation Server för Jenkins v5.3.4 eller senare.

captureConsole - Avbilda konsolens utdata och vänta tills den har slutförts
boolean. Standardvärde: true.

Om den här indata anges avbildas Jenkins-byggkonsolens utdata, väntar tills Jenkins-versionen har slutförts och lyckas/misslyckas baserat på Jenkins-byggresultatet. Annars slutförs det här steget utan att vänta på att Jenkins-versionen ska köras när Jenkins-jobbet köar.

capturePipeline - Samla in pipelineutdata och vänta tills pipelinen har slutförts
boolean. Valfritt. Använd när captureConsole = true. Standardvärde: true.

Om den här indata anges avbildas de fullständiga pipeline-konsolutdata för Jenkins-byggen, väntar tills den fullständiga Jenkins-bygg-pipelinen har slutförts och lyckas/misslyckas baserat på resultatet från Jenkins-bygg-pipelinen. När det första Jenkins-jobbet har slutförts slutförs annars indata utan att vänta på att den fullständiga Jenkins-bygg-pipelinen ska köras.

parameterizedJob - Parametriserat jobb
boolean. Standardvärde: false.

Anger om Jenkins-jobbet accepterar parametrar. Använd dessa indata även om alla standardparametervärden används och inga parametrar har angetts.

jobParameters - Jobbparametrar
string. Valfritt. Använd när parameterizedJob = true.

Anger jobbparametrar med en per rad, till exempel: <parameterName>=<parameterValue>.

Om du vill ange ett tomt värde för en parameter, vilket är användbart för att åsidosätta ett standardvärde, lämnar du parametervärdet. Ange till exempel <parameterName>=.

Variabler stöds. Om du till exempel vill ange ett commitId parametervärde till git-inchecknings-ID:t för versionen kan du använda: commitId=$(Build.SourceVersion). Mer information finns i dokumentationen om variabler.

Jenkins-parametertyper som stöds är:

Boolean
Choice
Password
String

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	Alla agentversioner som stöds.
Uppgiftskategori	Build

Dela via