Delen via


JenkinsQueueJob@1 - Jenkins Queue Job v1-taak

Gebruik deze taak om een taak in de wachtrij te plaatsen op een Jenkins-server.

Opmerking

Deze taak wordt afgekeurd; Gebruik JenkinsQueueJob@2.

Syntaxis

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

Invoer

serverEndpoint - Jenkins-service-eindpunt
string. Verplicht.

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


jobName - taaknaam
string. Verplicht.

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 pijplijntype Multibranch
boolean. Standaardwaarde: false.

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


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 vereist voor Jenkins v5.3.4 of hoger.


captureConsole - Capture-console-uitvoer en wacht op voltooiing
boolean. Standaardwaarde: true.

Indien opgegeven, legt deze invoer de uitvoer van de Jenkins-buildconsole vast, wacht totdat de Jenkins-build is voltooid en slaagt/mislukt op basis van het Jenkins-buildresultaat. Als 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. Facultatief. Gebruiken wanneer captureConsole = true. Standaardwaarde: true.

Indien opgegeven, legt deze invoer de volledige uitvoer van de Jenkins-buildpijplijnconsole vast, wacht tot de volledige Jenkins-build-pijplijn is voltooid en slaagt/mislukt op basis van het resultaat van de Jenkins-buildpijplijn. Als 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 worden opgegeven.


jobParameters - taakparameters
string. Facultatief. Gebruiken wanneer parameterizedJob = true.

Hiermee geeft u taakparameters 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 <parameterName>=bijvoorbeeld op.

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

De ondersteunde Jenkins-parametertypen zijn:

  • Boolean
  • Choice
  • Password
  • String

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Geen
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Welk dan ook
variabelen instellen Welk dan ook
Agentversie Alle ondersteunde agentversies.
Taakcategorie Bouwen