Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Använd den här uppgiften för att köa ett jobb på en Jenkins-server.
Syntax
# 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.
Ingångar
serverEndpoint
-
Slutpunkt för Jenkins-tjänsten
string. Obligatoriskt.
Anger tjänstslutpunkten för Jenkins-instansen. Klicka på länken Hantera (när du använder aktivitetsassistenten) för att skapa en ny Jenkins-tjänstslutpunkt.
jobName
-
jobbnamn
string. Obligatoriskt.
Namnet på Jenkins-jobbet som ska köas. Detta måste exakt matcha jobbnamnet på Jenkins-servern.
isMultibranchJob
-
Jobbet är av typen Multibranch Pipeline
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
-
Rörledningsgren med flera grenar
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, när Jenkins-jobbet köas, slutförs det här steget 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 det anges samlar dessa indata in fullständiga utdata från Jenkins-bygg-pipeline-konsolen, väntar på att den fullständiga Jenkins-bygg-pipelinen ska slutföras och lyckas/misslyckas baserat på resultatet av Jenkins-bygg-pipelinen. Annars, när det första Jenkins-jobbet har slutförts, slutförs dessa indata utan att vänta på att den fullständiga Jenkins-bygg-pipelinen ska köras.
parameterizedJob
-
Parameteriserat jobb
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, till exempel: <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:
BooleanChoicePasswordString
Alternativ för uppgiftskontroll
Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.
Utdatavariabler
Ingen.
Kravspecifikation
| Krav | Beskrivning |
|---|---|
| Pipelinetyper | YAML, klassisk version, klassisk version |
| Körs på | Agent, DeploymentGroup |
| Krav | Ingen |
| Kapaciteter | 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 | Alla agentversioner som stöds. |
| Aktivitetskategori | Skapa |