DownloadBuildArtifacts@1 – Build artifacts v1 feladat letöltése
Ezzel a feladatsal letöltheti a befejezett build összetevőiként mentett fájlokat.
Az Azure DevOps Services használata esetén javasoljuk, hogy a gyorsabb teljesítmény érdekében használja a Folyamatösszetevők letöltése és a Folyamatösszetevők közzététele lehetőséget.
Syntax
# Download build artifacts v1
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@1
inputs:
buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
#project: # string. Required when buildType == specific. Project.
#pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline.
#specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
#buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
#allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
#branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
#buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build.
#tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags.
downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
artifactName: # string. Required when downloadType == single. Artifact name.
#itemPattern: '**' # string. Matching pattern. Default: **.
downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
#cleanDestinationFolder: false # boolean. Clean destination folder. Default: false.
# Advanced
#parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
#checkDownloadedFiles: false # boolean. Check downloaded files. Default: false.
#retryDownloadCount: '4' # string. Retry count. Default: 4.
#extractTars: # boolean. Extract all files that are stored inside tar archives.
Bevitelek
buildType
- Az által előállított összetevők letöltése
string
. Kötelező. Engedélyezett értékek: current
(Aktuális build), specific
(Adott build). Alapértelmezett érték: current
.
Akár az aktuális build által létrehozott összetevőket szeretné letölteni, akár egy adott buildből.
project
- Projekt
string
. Akkor szükséges, ha buildType == specific
.
Az a projekt, amelyből le szeretné tölteni a buildösszetevőket.
pipeline
- Folyamat létrehozása
Bemeneti alias: definition
. string
. Akkor szükséges, ha buildType == specific
.
Megadja a buildelési folyamat nevét.
specificBuildWithTriggering
- Szükség esetén töltse le az összetevőket az eseményindító buildből.
boolean
. Választható. Használja a következőt: buildType == specific
. Alapértelmezett érték: false
.
Ha true
, akkor ez a buildelési feladat megpróbál összetevőket letölteni az eseményindító buildből. Ha a megadott folyamatból nem indítja el a buildet, az összetevőket az alábbi beállításokban megadott buildből tölti le.
buildVersionToDownload
- Letölthető buildverzió
string
. Akkor szükséges, ha buildType == specific
. Engedélyezett értékek: latest
, latestFromBranch
(Legújabb az adott ágból és a megadott buildcímkékből), specific
(Adott verzió). Alapértelmezett érték: latest
.
Meghatározza, hogy a build melyik verzióját töltse le.
- Válassza ki
latest
, hogy letölti-e a legújabb elérhető buildverziót. - Válassza ki
latestFromBranch
, hogy letölti a által megadottbranchName
ág legújabb elérhető buildverzióját és a által megadott címkékettags
. - Válassza a
specific
által megadott buildverzió letöltésétbuildId
.
allowPartiallySucceededBuilds
- A részlegesen sikeres buildekből is letölthet összetevőket.
boolean
. Választható. Használja a következőt: buildType == specific && buildVersionToDownload != specific
. Alapértelmezett érték: false
.
Ha true
, akkor ez a buildelési feladat megpróbál összetevőket letölteni, függetlenül attól, hogy a build sikeres vagy részlegesen sikeres.
branchName
- Ág neve
string
. Akkor szükséges, ha buildType == specific && buildVersionToDownload == latestFromBranch
. Alapértelmezett érték: refs/heads/master
.
Megadja, hogy az ág/hiv név alapján szűrjön-e, például: refs/heads/develop
.
buildId
- Épít
string
. Akkor szükséges, ha buildType == specific && buildVersionToDownload == specific
.
A build, amelyből le szeretné tölteni az összetevőket.
tags
- Buildcímkék
string
. Választható. Használja a következőt: buildType == specific && buildVersionToDownload != specific
.
Címkék vesszővel tagolt listája. A rendszer csak az ezekkel a címkékkel rendelkező buildeket adja vissza.
downloadType
- Letöltés típusa
string
. Kötelező. Engedélyezett értékek: single
(Adott összetevő), specific
(Adott fájlok). Alapértelmezett érték: single
.
Letölt egy adott összetevőt vagy adott fájlokat a buildből.
- Válassza az
single
(Adott összetevő) lehetőséget, ha csak egy adott összetevőt szeretne megadniartifactName
- Válassza az
specific
(Adott fájlok) lehetőséget, ha a kijelölt build összes összetevőjéhez szüksége van
artifactName
- Összetevő neve
string
. Akkor szükséges, ha downloadType == single
.
A letölteni kívánt összetevő neve.
itemPattern
- Egyező minta
string
. Alapértelmezett érték: **
.
A letöltendő fájlokat többsoros minimatch mintaként adja meg. További információ: Fájlegyeztetési minták referenciája.
Az alapértelmezett minta \*\*
az összes fájlt letölti a build összes összetevőjéről, ha az Adott fájlok lehetőséget választja. Az összetevő-legördülő menüben található összes fájl letöltéséhez használja a következőt drop/**
: .
downloadPath
- Célkönyvtár
string
. Kötelező. Alapértelmezett érték: $(System.ArtifactsDirectory)
.
Az ügynökgép elérési útja, ahol az összetevők letöltődnek.
cleanDestinationFolder
- Célmappa törlése
boolean
. Alapértelmezett érték: false
.
Az összetevő letöltése előtt törölje a célmappa összes meglévő fájlját.
parallelizationLimit
- Párhuzamosítási korlát
string
. Alapértelmezett érték: 8
.
Az egyidejűleg letöltendő fájlok száma.
checkDownloadedFiles
- Letöltött fájlok ellenőrzése
boolean
. Alapértelmezett érték: false
.
Ha true
a , ez a buildelési feladat ellenőrzi, hogy az összes fájl teljes mértékben le van-e töltve.
retryDownloadCount
- Újrapróbálkozás száma
string
. Alapértelmezett érték: 4
.
A buildösszetevő letöltésének újrapróbálkozási száma, ha a letöltés sikertelen.
extractTars
- A tar archívumban tárolt összes fájl kibontása
boolean
.
Állítsa úgy, true
hogy kinyerje az összes letöltött fájlt, amely .tar kiterjesztéssel rendelkezik. Ez azért hasznos, mert ha meg szeretné őrizni a Unix-fájlengedélyeket, akkor az összetevőfájlokat tar-ba kell csomagolnia. A Buildösszetevők közzététele feladatban a beállítás engedélyezésével StoreAsTar
az összetevők automatikusan .tar fájlként lesznek tárolva.
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.
BuildNumber
A buildösszetevő-forrás buildszámát tárolja.
Vegye figyelembe, hogy ez a bemenet a buildazonosítót adja vissza a visszamenőleges kompatibilitás miatt. További információ: Változók.
Megjegyzések
Megjegyzés
Az Azure Pipelines csapata azt javasolja, hogy a gyorsabb teljesítmény érdekében frissítsen a buildösszetevőkrőla Pipeline Artifactsre .
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 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 | 2.191.1 vagy újabb |
Feladatkategória | Segédprogram |
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: