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

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.

Indata

serverEndpoint - Jenkins-tjänstanslutning
string. Krävs.

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

jobName - Jobbnamn
string. Krävs.

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

isMultibranchJob - Jobbet är av pipelinetypen multibranch
boolean. Standardvärde: false.

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

multibranchPipelineBranch - Gren för flerslangspipeline
string. Krävs när isMultibranchJob = true.

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

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

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

capturePipeline - Samla in 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 samlar den in 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 från Jenkins-bygg-pipelinen. När det första Jenkins-jobbet har slutförts slutförs annars den här uppgiften utan att vänta på att den fullständiga Jenkins-bygg-pipelinen ska köras.

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

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

Jenkins-parametertyper som stöds är:

• Boolean
• Choice
• Password
• String

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

Anger strikthet för en lyckad definition, eller om du vill betrakta unstable som ett fel eller inte. Värdet false är för en icke-strikt version och true är för en strikt version. Om det är inställt på 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 uppstår.

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 uppstår. 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 aktiviteten definierar följande utdatavariabler, som du kan använda i underordnade steg, jobb och faser.

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

Kommentarer

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 Plugin-programmet Team Foundation Server på Jenkins-servern .

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

3. I Jenkins-köjobbet aktiverar byggaktiviteten avbildningskonsolens utdata och väntar på slutförande för att samla in resultat från rotnivåjobbet eller avbildningspipelineutdata och väntar på att pipelinen ska slutföras 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
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	2.144.0 eller senare
Uppgiftskategori	Build