JenkinsQueueJob@2 - Jenkins-wachtrijtaak v2-taak

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

Syntax

# Jenkins queue job v2
# Queue a job on a Jenkins server.
- task: JenkinsQueueJob@2
  inputs:
    serverEndpoint: # string. Required. Jenkins service connection. 
    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
    #isParameterizedJob: false # boolean. Alias: parameterizedJob. Parameterized job. Default: false.
    #jobParameters: # string. Optional. Use when parameterizedJob = true. Job parameters. 
    #failOnUnstableResult: false # boolean. Fail on unstable result. Default: false.
    #retryCount: '3' # string. Number of retries for failed connection. Default: 3.
    #delayBetweenRetries: '60' # string. Time between retries. Default: 60.

Invoerwaarden

serverEndpoint - Jenkins-serviceverbinding
string. Vereist.

Hiermee geeft u de serviceverbinding voor uw Jenkins-exemplaar op. Klik op de koppeling Beheren om een nieuwe Jenkins-serviceverbinding 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 - De taak is van het pijplijntype multibranch
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 Jenkins-buildresultaat. Anders wordt deze taak voltooid nadat de Jenkins-taak in wachtrijen is geplaatst, 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, legt deze taak 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 anders is voltooid, wordt deze taak voltooid zonder te wachten tot de volledige Jenkins-build-pijplijn wordt uitgevoerd.

isParameterizedJob - Geparameteriseerde taak
Invoeralias: parameterizedJob. 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 daadwerkelijk zijn opgegeven.

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

Hiermee geeft u taakparameters, met één per regel, in de indeling van <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 staan. 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 het volgende gebruiken: commitId=$(Build.SourceVersion). Zie de documentatie over variabelen voor meer informatie.

De ondersteunde Jenkins-parametertypen zijn:

• Boolean
• Choice
• Password
• String

failOnUnstableResult - Mislukt bij instabiel resultaat
boolean. Standaardwaarde: false.

Hiermee geeft u de striktheid van een geslaagde definitie op of u instabiel als een fout moet beschouwen of niet. De false waarde is voor een niet-strikte versie en de true is voor een strikte versie. Als dit is ingesteld op true, wordt een onstabiel buildresultaat behandeld als een fout. Anders wordt een onstabiel resultaat behandeld als een geslaagd resultaat.

retryCount - Aantal nieuwe pogingen voor mislukte verbinding
string. Standaardwaarde: 3.

Hiermee geeft u de hoeveelheid nieuwe pogingen voor verbindingen op wanneer een verbindingsfout of -fout optreedt.

delayBetweenRetries - Tijd tussen nieuwe pogingen
string. Standaardwaarde: 60.

Hiermee geeft u de hoeveelheid tijd tussen nieuwe pogingen voor de verbinding wanneer een fout optreedt. Deze waarde wordt in seconden opgegeven.

Opties voor taakbeheer

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

Uitvoervariabelen

Deze taak definieert de volgende uitvoervariabelen, die u kunt gebruiken in downstreamstappen, taken en fasen.

JENKINS_JOB_ID
De id van het Jenkins-taakexemplaren die door deze taak in de wachtrij zijn geplaatst. Gebruik deze variabele in de taak Jenkins-downloadartefacten om de artefacten voor dit specifieke taakexemplaren te downloaden.

Opmerkingen

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

Team Foundation Server-invoegtoepassing

U kunt de Team Foundation Server-invoegtoepassing (versie 5.2.0 of hoger) gebruiken om automatisch bestanden te verzamelen uit de Jenkins-werkruimte en deze te downloaden naar de build.

Ga als volgende te werk om dit in te stellen:

1. Installeer de Team Foundation Server-invoegtoepassing op de Jenkins-server .

2. Voeg op de Jenkins-server voor elke taak waarvan u resultaten wilt verzamelen, de actie Resultaten verzamelen voor Azure Pipelines/TFS toe en configureer deze vervolgens met een of meer paren van het resultaattype en het bestandspatroon opnemen.

3. Schakel in de Jenkins-wachtrijtaak de build-taak de uitvoer van de console vastleggen in en wacht totdat de resultaten van de taak op hoofdniveau worden verzameld, of de uitvoer van de pijplijn vastleggen en wacht totdat de pijplijn is voltooid om resultaten van alle pijplijntaken te verzamelen.

De resultaten worden gedownload naar de $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results.zip en naar deze locatie geëxtraheerd. Elke set resultaattypen die door de invoegtoepassing worden verzameld, bevindt zich in de map teamresultaten, $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results/ResultType/. Dit is de map waarin buildresultaten kunnen worden gepubliceerd door downstreamtaken (bijvoorbeeld Testresultaten publiceren en Resultaten van codedekking publiceren).

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	2.144.0 of hoger
Taakcategorie	Build