DownloadBuildArtifacts@1 – Build-összetevők v1-feladatának letöltése

Ezzel a feladatsal letöltheti azokat a fájlokat, amelyeket egy befejezett build összetevőjeként mentettek.

Az Azure DevOps Services használata esetén javasoljuk, hogy folyamatösszetevők letöltését és a folyamatösszetevők közzétételét a gyorsabb teljesítmény érdekében.

Szemantika

# 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.

Bemenetek

buildType - által előállított összetevők letöltése
string. Szükséges. 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, akár egy adott buildből szeretné letölteni.

project - Projekt
string. buildType == specificesetén kötelező.

Az a projekt, amelyből letöltheti a build-összetevőket.

pipeline - buildelési folyamat
Bemeneti alias: definition. string. buildType == specificesetén kötelező.

Megadja a buildelési folyamat nevét.

specificBuildWithTriggering - Adott esetben töltse le az összetevőket az eseményindító buildből.
boolean. Opcionális. Használja a buildType == specific. Alapértelmezett érték: false.

Ha true, ez a buildelési feladat megpróbál összetevőket letölteni az eseményindító buildből. Ha nincs aktiváló build a megadott folyamatból, az összetevőket az alábbi beállításokban megadott buildből tölti le.

buildVersionToDownload - buildverzió letöltése
string. buildType == specificesetén kötelező. Engedélyezett értékek: latest, latestFromBranch (adott ág és megadott buildcímkék legújabb verziója), specific (adott verzió). Alapértelmezett érték: latest.

Megadja, hogy a build melyik verzióját szeretné letölteni.

• Válassza latest a legújabb elérhető buildverzió letöltését.
• Válassza latestFromBranch a által branchName megadott ág és a megadott címkék tagslegújabb elérhető buildverziójának letöltését.
• Válassza specific a .buildId

allowPartiallySucceededBuilds - Összetevők letöltése még a részben sikeres buildekből is.
boolean. Opcionális. Használja a buildType == specific && buildVersionToDownload != specific. Alapértelmezett érték: false.

Ha true, ez a buildelési feladat megpróbálja letölteni az összetevőket, függetlenül attól, hogy a build sikeres vagy részben sikeres.

branchName - ágnév
string. buildType == specific && buildVersionToDownload == latestFromBranchesetén kötelező. Alapértelmezett érték: refs/heads/master.

Megadja, hogy az ág/hiv név alapján szeretne-e szűrni, például: refs/heads/develop.

buildId - Összeállítás
string. buildType == specific && buildVersionToDownload == specificesetén kötelező.

Az a build, amelyből le szeretné tölteni az összetevőket.

tags - buildcímkék
string. Opcionális. Használja a buildType == specific && buildVersionToDownload != specific.

A 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. Szükséges. 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 (Adott összetevő) lehetőséget single , ha csak egy adott összetevőt szeretne megadni artifactName
• Válassza az (Adott fájlok) lehetőséget specific , ha a kiválasztott build összes összetevőjét szeretné

artifactName - összetevő neve
string. downloadType == singleesetén kötelező.

A letölteni kívánt összetevő neve.

itemPattern - Egyező minta
string. Alapértelmezett érték: **.

Megadja a letöltendő fájlokat többsoros minimatch mintaként. További információ: Fájlmegfeleltetési minták hivatkozása.

Az alapértelmezett minta \*\* letölti az összes fájlt a build összes összetevőjéhez, ha a Adott fájlok lehetőséget választja. Az összetevő cseppen belüli összes fájl letöltéséhez használja a drop/**.

downloadPath - Célkönyvtár
string. Szükséges. Alapértelmezett érték: $(System.ArtifactsDirectory).

Annak az ügynökgépnek az elérési útja, ahol az összetevők letöltődnek.

További információ: System.ArtifactsDirectoryVáltozók használata klasszikus kiadási folyamatokban.

cleanDestinationFolder - Célmappa törlése
boolean. Alapértelmezett érték: false.

Törölje az összes meglévő fájlt a célmappában az összetevő letöltése előtt.

parallelizationLimit - párhuzamossági 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, 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 ideje, ha a letöltés sikertelen.

extractTars - A tar archívumban tárolt összes fájl kinyerés
boolean.

Állítsa be az true összes letöltött fájl kibontását, amely a .tar kiterjesztéssel rendelkezik. Ez azért hasznos, mert a műtermékfájlokat tar fájlba kell csomagolnia, ha meg szeretné őrizni a Unix fájlengedélyeket. Ha engedélyezi a beállítást StoreAsTar a Buildösszetevők közzététele feladatban, a rendszer automatikusan .tar fájlként tárolja a műtermékeket.

Feladatvezérlési lehetőségek

Minden tevékenység a tevékenységbemeneteken kívül vezérlési lehetőségekkel is rendelkezik. További információ: Vezérlők é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
Tárolja a build-összetevő forrásának buildszámát.

Vegye figyelembe, hogy ez a bemenet visszafelé kompatibilitás miatt BuildId ad vissza. 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 folyamat-összetevőkre .

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás bekapcsolva	Ügynök, DeploymentGroup
Igények	Egyik sem
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ármely
Változók beállítása	Bármely
Ügynök verzió	2.191.1 vagy újabb
Tevékenységkategória	Hasznosság