Delen via

JenkinsQueueJob@1 - Jenkins Queue Job v1-taak

  • Artikel

Gebruik deze taak om een taak in de wachtrij te plaatsen op een 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.

Invoerwaarden

serverEndpoint - Jenkins-service-eindpunt
string. Vereist.

Hiermee geeft u het service-eindpunt voor uw Jenkins-exemplaar op. Klik op de koppeling Beheren (wanneer u de taak gebruikt assistent) om een nieuw Jenkins-service-eindpunt te maken.


jobName - Taaknaam
string. Vereist.

De naam van de Jenkins-taak die in de wachtrij moet worden geplaatst. Dit moet exact overeenkomen met de taaknaam op de Jenkins-server.


isMultibranchJob - Taak is van het type Multibranch-pijplijn
boolean. Standaardwaarde: false.

Deze taak is een multibranch-pijplijn. Voeg, indien opgegeven, de juiste vertakkingsnaam toe. Voor deze invoer is de Team Foundation Server-invoegtoepassing voor Jenkins v5.3.4 of hoger vereist.


multibranchPipelineBranch - Multibranch-pijplijnbranch-vertakking
string. Vereist wanneer isMultibranchJob = true.

Hiermee wordt deze multibranch-pijplijntaak in de opgegeven vertakking in de wachtrij geplaatst. Voor deze invoer is de Team Foundation Server-invoegtoepassing voor Jenkins v5.3.4 of hoger vereist.


captureConsole - Console-uitvoer vastleggen en wachten op voltooiing
boolean. Standaardwaarde: true.

Indien opgegeven, legt deze invoer de uitvoer van de Jenkins-buildconsole vast, wacht tot de Jenkins-build is voltooid en slaagt/mislukt op basis van het resultaat van de Jenkins-build. Zodra de Jenkins-taak in de wachtrij staat, wordt deze stap voltooid zonder te wachten totdat de Jenkins-build wordt uitgevoerd.


capturePipeline - Pijplijnuitvoer vastleggen en wachten tot de pijplijn is voltooid
boolean. Optioneel. Gebruik wanneer captureConsole = true. Standaardwaarde: true.

Indien opgegeven, wordt met deze invoer de volledige uitvoer van de Jenkins-buildpijplijnconsole vastgelegd, wordt gewacht tot de volledige Jenkins-build-pijplijn is voltooid en slaagt/mislukt op basis van het resultaat van de Jenkins-buildpijplijn. Zodra de eerste Jenkins-taak is voltooid, wordt deze invoer voltooid zonder te wachten tot de volledige Jenkins-build-pijplijn wordt uitgevoerd.


parameterizedJob - Geparameteriseerde taak
boolean. Standaardwaarde: false.

Hiermee geeft u op of de Jenkins-taak parameters accepteert. Gebruik deze invoer zelfs als alle standaardparameterwaarden worden gebruikt en er geen parameters zijn opgegeven.


jobParameters - Taakparameters
string. Optioneel. Gebruik wanneer parameterizedJob = true.

Hiermee geeft u taakparameters op met één per regel, bijvoorbeeld: <parameterName>=<parameterValue>.

Als u een parameter wilt instellen op een lege waarde, wat handig is voor het overschrijven van een standaardwaarde, laat u de parameterwaarde weg. Geef bijvoorbeeld op <parameterName>=.

Variabelen worden ondersteund. Als u bijvoorbeeld een commitId parameterwaarde wilt instellen op de Git-doorvoer-id van de build, kunt u: gebruiken. commitId=$(Build.SourceVersion) Zie de documentatie over variabelen voor meer informatie.

De ondersteunde Jenkins-parametertypen zijn:

  • Boolean
  • Choice
  • Password
  • String

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Geen
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie Alle ondersteunde agentversies.
Taakcategorie Build