JenkinsQueueJob@2 - Jenkins-wachtrijtaak v2-taak

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

Syntaxis

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

Invoer

serverEndpoint - Jenkins-serviceverbinding
string. Verplicht.

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. 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. Anders wordt deze taak voltooid zodra de Jenkins-taak in de wachtrij staat, 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 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 is voltooid, wordt deze taak voltooid zonder te wachten tot de volledige Jenkins-buildpijplijn 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 worden opgegeven.

jobParameters - taakparameters
string. Facultatief. Gebruiken 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 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

failOnUnstableResult - mislukt bij instabiele resultaten
boolean. Standaardwaarde: false.

Hiermee geeft u de striktheid van een succesdefinitie aan of u onstabiel als een fout wilt 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 instabiele buildresultaat behandeld als een fout. Anders wordt een instabiel resultaat behandeld als een succes.

retryCount - aantal nieuwe pogingen voor mislukte verbindingen
string. Standaardwaarde: 3.

Hiermee geeft u de hoeveelheid nieuwe pogingen van de verbinding op wanneer er een verbindingsfout of fout optreedt.

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

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

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor 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 in de wachtrij voor deze taak. Gebruik deze variabele in de taak Jenkins Artefacten downloaden 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 invoegtoepassing Team Foundation Server (versie 5.2.0 of hoger) gebruiken om automatisch bestanden te verzamelen uit de Jenkins-werkruimte en deze te downloaden in de build.

Ga als volgende te werk om het in te stellen:

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

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

3. In de Jenkins-wachtrijtaak schakelt u de uitvoer van de Capture-console in en wacht u op voltooiing resultaten van de hoofdtaak te verzamelen, of de Capture-pijplijnuitvoer en wacht u tot de pijplijn is voltooid resultaten van alle pijplijntaken te verzamelen.

Resultaten worden gedownload naar de $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results.zip en geëxtraheerd naar deze locatie. Elke set resultatentypen die door de invoegtoepassing worden verzameld, bevindt zich onder 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

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