JenkinsQueueJob@2 – Jenkins queue job v2 feladat
Ezzel a feladatsal várólistára helyezhet egy feladatot egy Jenkins-kiszolgálón.
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.
# 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.
# 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.
Bevitelek
serverEndpoint
- Jenkins szolgáltatáskapcsolat
string
. Kötelező.
Megadja a Jenkins-példány szolgáltatáskapcsolatát. Kattintson a Kezelés hivatkozásra egy új Jenkins-szolgáltatáskapcsolat létrehozásához.
jobName
- Feladat neve
string
. Kötelező.
Az várólistára helyezendő Jenkins-feladat neve. Ennek pontosan meg kell egyeznie a Jenkins-kiszolgálón lévő feladat nevével.
isMultibranchJob
- A feladat többfázisú folyamattípusú
boolean
. Alapértelmezett érték: false
.
Ez a feladat egy többtényezős folyamat. Ha meg van adva, adja hozzá a megfelelő ágnevet. Ehhez a bemenethez a Jenkins 5.3.4-ös vagy újabb verziójához szükséges a Team Foundation Server beépülő modulja.
multibranchPipelineBranch
- Többágú folyamatág
string
. Akkor szükséges, ha isMultibranchJob = true
.
Várólistára állítja ezt a többtényezős folyamatfeladatot a megadott ágon. Ehhez a bemenethez a Jenkins 5.3.4-ös vagy újabb verziójához szükséges a Team Foundation Server beépülő modulja.
captureConsole
- Rögzítse a konzol kimenetét, és várja meg a befejezést
boolean
. Alapértelmezett érték: true
.
Ha meg van adva, ez a bemenet rögzíti a Jenkins buildkonzol kimenetét, megvárja, amíg a Jenkins-build befejeződik, és a Jenkins-build eredménye alapján sikeres/sikertelen lesz. Ellenkező esetben, ha a Jenkins-feladat várólistára kerül, ez a feladat sikeresen befejeződik anélkül, hogy a Jenkins-build futtatására várna.
capturePipeline
- Folyamatkimenet rögzítése és várakozás a folyamat befejezésére
boolean
. Választható. Használja a következőt: captureConsole = true
. Alapértelmezett érték: true
.
Ha meg van adva, ez a feladat rögzíti a Jenkins buildelési folyamat konzoljának teljes kimenetét, megvárja, amíg a teljes Jenkins-buildfolyamat befejeződik, és a Jenkins buildelési folyamat eredménye alapján sikeres vagy sikertelen lesz. Ellenkező esetben az első Jenkins-feladat befejeződése után ez a feladat sikeresen befejeződik anélkül, hogy a teljes Jenkins buildfolyamat futtatására várna.
isParameterizedJob
- Paraméterezett feladat
Bemeneti alias: parameterizedJob
. boolean
. Alapértelmezett érték: false
.
Megadja, hogy a Jenkins-feladat elfogadja-e a paramétereket. Akkor is használja ezt a bemenetet, ha az összes alapértelmezett paraméterértéket használja, és nincs megadva paraméter.
jobParameters
- Feladatparaméterek
string
. Választható. Használja a következőt: parameterizedJob = true
.
A feladatparamétereket adja meg, soronként <parameterName>=<parameterValue>
egy formátumban.
Ha egy paramétert üres értékre szeretne állítani, amely hasznos egy alapértelmezett érték felülírásához, hagyja ki a paraméter értékét. Adja meg például a következőt parameterName=
: .
A változók támogatottak. Ha paraméterértéket commitId
szeretne beállítani a build Git véglegesítési azonosítójára, használhatja például a következőt: commitId=$(Build.SourceVersion)
. További információt a változók dokumentációjában talál.
A támogatott Jenkins-paramétertípusok a következők:
Boolean
Choice
Password
String
failOnUnstableResult
- Instabil eredmény meghiúsulása
boolean
. Alapértelmezett érték: false
.
Meghatározza a sikerdefiníciók szigorúságát, vagy azt, hogy a hiba nem stabil-e vagy sem. Az false
érték egy nem szigorú verzióra, a pedig true
egy szigorú verzióra. Ha a értékre true
van állítva, az instabil buildelési eredményt a rendszer hibaként kezeli. Ellenkező esetben az instabil eredmény sikerként lesz kezelve.
retryCount
- Sikertelen kapcsolathoz tartozó újrapróbálkozási próbálkozások száma
string
. Alapértelmezett érték: 3
.
Megadja a csatlakozási újrapróbálkozások mennyiségét kapcsolathiba vagy hiba esetén.
delayBetweenRetries
- Újrapróbálkozások közötti idő
string
. Alapértelmezett érték: 60
.
Megadja a kapcsolat újrapróbálkozásai közötti időt hiba esetén. Ez az érték másodpercben van megadva.
Feladatvezérlési lehetőségek
Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.
Kimeneti változók
Ez a feladat a következő kimeneti változókat határozza meg, amelyeket az alsóbb rétegbeli lépésekben, feladatokban és szakaszokban használhat fel.
JENKINS_JOB_ID
A feladat által várólistára helyezett Jenkins-feladatpéldány azonosítója. Használja ezt a változót a Jenkins Download Artifacts (Összetevők letöltése) feladatban az adott feladatpéldány összetevőinek letöltéséhez.
Megjegyzések
Ezzel a feladatsal várólistára helyezhet egy feladatot egy Jenkins-kiszolgálón.
Team Foundation Server beépülő modul
A Team Foundation Server beépülő modul (5.2.0-s vagy újabb verzió) használatával automatikusan gyűjthet fájlokat a Jenkins-munkaterületről, és letöltheti őket a buildbe.
Beállításához:
Telepítse a Team Foundation Server beépülő modult a Jenkins-kiszolgálón .
A Jenkins-kiszolgálón minden olyan feladathoz, amelyből eredményeket szeretne gyűjteni, adja hozzá az Eredmények gyűjtése az Azure Pipelines/TFS buildelés utáni műveletéhez, majd konfigurálja azt egy vagy több eredménytípus párjával, és adja meg a fájlmintát.
A Jenkins-üzenetsor-feladatban a buildelési feladat engedélyezi a rögzítési konzol kimenetét, és várja meg a befejezést a gyökérszintű feladat vagy a Folyamat kimenetének rögzítése, és várja meg , hogy a folyamat befejezése az összes folyamatfeladat eredményeit összegyűjtse.
Az eredmények a $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results.zip fájlba lesznek letöltve, és erre a helyre lesznek kinyerve. A beépülő modul által gyűjtött eredménytípusok mindegyike a $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results/ResultType/ csapateredmények könyvtárában lesz. Ez az a könyvtár, ahol a builderedmények közzétehetők alsóbb rétegbeli tevékenységek (például Teszteredmények közzététele és Kódlefedettségi eredmények közzététele).
Követelmények
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build, klasszikus kiadás |
Futtatás | Ügynök, DeploymentGroup |
Igények | None |
Képességek | Ez a feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek. |
Parancskorlátozások | Bármelyik |
Változók beállítása | Bármelyik |
Ügynök verziója | 2.144.0 vagy újabb |
Feladatkategória | Build |
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build, klasszikus kiadás |
Futtatás: | Ügynök, DeploymentGroup |
Igények | None |
Képességek | Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek. |
Parancskorlátozások | Bármelyik |
Változók beállítása | Bármelyik |
Ügynök verziója | Minden támogatott ügynökverzió. |
Feladatkategória | Build |