JenkinsQueueJob@2 – Jenkins-köjobb v2-uppgift

Använd den här uppgiften för att köa ett jobb på en 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.

Ingångar

serverEndpoint - Jenkins-tjänstanslutning
string. Obligatoriskt.

Anger tjänstanslutningen för Jenkins-instansen. Klicka på länken Hantera för att skapa en ny Jenkins-tjänstanslutning.

jobName - jobbnamn
string. Obligatoriskt.

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

isMultibranchJob - Jobb är av pipelinetyp för flera
boolean. Standardvärde: false.

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

multibranchPipelineBranch - multibranch-pipelinegren
string. Krävs när isMultibranchJob = true.

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

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

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

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

Om den här uppgiften anges avbildas de fullständiga utdata från Jenkins-bygg-pipelinekonsolen, väntar på att den fullständiga Jenkins-bygg-pipelinen ska slutföras och lyckas/misslyckas baserat på resultatet av Jenkins-bygg-pipelinen. Annars slutförs den här uppgiften utan att vänta på att hela Jenkins-bygg-pipelinen ska köras när det första Jenkins-jobbet har slutförts.

isParameterizedJob - Parameteriserat jobb
Indataalias: parameterizedJob. boolean. Standardvärde: false.

Anger om Jenkins-jobbet accepterar parametrar. Använd den här indatan ä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, i formatet <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 vill ange ett commitId parametervärde till Git-inchecknings-ID:t för versionen kan du till exempel använda: commitId=$(Build.SourceVersion). Mer information finns i dokumentation om variabler.

Jenkins-parametertyper som stöds är:

• Boolean
• Choice
• Password
• String

failOnUnstableResult - Misslyckas vid instabilt resultat
boolean. Standardvärde: false.

Anger strikthet för en framgångsdefinition, eller om du vill betrakta instabil som ett fel eller inte. Det false värdet är för en icke-strikt version och true är för en strikt version. Om värdet är truebehandlas ett instabilt byggresultat som ett fel. Annars behandlas ett instabilt resultat som ett lyckat resultat.

retryCount - Antal återförsök för misslyckad anslutning
string. Standardvärde: 3.

Anger hur många anslutningsförsök som ska utföras när anslutningsfel eller -fel inträffar.

delayBetweenRetries - tid mellan återförsök
string. Standardvärde: 60.

Anger hur lång tid det tar mellan anslutningsförsök när ett fel inträffar. Det här värdet anges i sekunder.

Kontrollalternativ för aktivitet

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

Utdatavariabler

Den här uppgiften definierar följande utdatavariabler, som du kan använda i underordnade steg, jobb och steg.

JENKINS_JOB_ID
ID:t för Jenkins-jobbinstansen i kö av den här uppgiften. Använd den här variabeln i aktiviteten Jenkins Download Artifacts för att ladda ned artefakterna för den här specifika jobbinstansen.

Anmärkningar

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

Plugin-program för Team Foundation Server

Du kan använda Plugin-programmet för Team Foundation Server (version 5.2.0 eller senare) för att automatiskt samla in filer från Jenkins-arbetsytan och ladda ned dem till bygget.

Så här konfigurerar du det:

1. Installera Team Foundation Server-plugin- på Jenkins-servern.

2. På Jenkins-servern, för varje jobb som du vill samla in resultat från, lägger du till Samla in resultat för Azure Pipelines/TFS åtgärden efter bygget och konfigurerar den sedan med ett eller flera par resultattyp och inkluderar filmönster.

3. På Jenkins-köjobbet aktiverar byggaktiviteten Capture-konsolens utdata och väntar på slutförande för att samla in resultat från rotnivåjobbet, eller Avbilda pipelineutdata och vänta tills pipelinen har slutförts för att samla in resultat från alla pipelinejobb.

Resultaten laddas ned till $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results.zip och extraheras till den här platsen. Varje uppsättning resultattyper som samlas in av plugin-programmet finns under katalogen team-results, $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results/ResultType/. Det här är den katalog där byggresultat kan publiceras av underordnade uppgifter (till exempel Publicera testresultat och Publicera kodtäckningsresultat).

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	2.144.0 eller senare
Aktivitetskategori	Skapa