DownloadBuildArtifacts@0 – Build artifacts v0 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.

Megjegyzés

Tiltsa le az alapszintű IIS-hitelesítést, ha Azure DevOps Server használja a személyes hozzáférési jogkivonattal történő hitelesítés engedélyezéséhez. További részletekért lásd: Alapszintű IIS-hitelesítés és PAT-k .

Syntax

# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
  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.
    #retryRedirectDownloadCount: '0' # string. Retry count for redirect download. Default: 0.
    #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.

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.

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örli 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 truea , 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.

retryRedirectDownloadCount - Átirányítás letöltésének újrapróbálkozásainak száma
string. Alapértelmezett érték: 0.

Ha az átirányításon alapuló letöltés sikertelen, a buildösszetevő letöltésének újrapróbálkozási száma nem kötelező. Ha a hálózat nem engedélyezi az átirányítás követését, beállíthatja -1 értékre, hogy mindig letöltse a streamelt választ az Azure DevOpsból.

extractTars - A tar archívumban tárolt összes fájl kibontása
boolean.

Kinyeri az összes olyan letöltött fájlt, amely rendelkezik kiterjesztéssel .tar . Ez azért hasznos, mert az összetevőfájlokat egy .tar fájlba kell csomagolnia, ha meg szeretné őrizni a Unix-fájl engedélyeit. StoreAsTar A PublishBuildArtifacts feladatban a beállítás engedélyezése automatikusan fájlokként .tar tárolja az összetevőket.

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ának 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.

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	Minden támogatott ügynökverzió.
Feladatkategória	Segédprogram