DownloadPipelineArtifact@1 – Folyamatösszetevő v1-feladat letöltése

Ezzel a feladatsal folyamatösszetevőket tölthet le a folyamat korábbi szakaszaiból vagy egy másik folyamatból.

A feladatnak van egy újabb verziója. További információ: DownloadPipelineArtifact@2.

Megjegyzés

További információkért, beleértve az Azure CLI-parancsokat is, tekintse meg az összetevők letöltését ismertető cikket.

Syntax

# Download Pipeline Artifacts v1
# Download a named artifact from a pipeline to a local path.
- task: DownloadPipelineArtifact@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.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).

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.

Letölti az aktuális folyamatfuttatás vagy egy adott folyamatfuttatás által előállított összetevőket.

project - Projekt
string. Akkor szükséges, ha buildType == specific.

Megadja a projekt nevét vagy GUID azonosítóját, amelyből le szeretné tölteni a folyamatösszetevőket.

pipeline - Folyamat létrehozása
Bemeneti alias: definition. string. Akkor szükséges, ha buildType == specific.

A folyamat definícióazonosítója. Egy futó folyamatban a definitionIdrendszer a System.DefinitionId változóban található. A definitionId az Azure DevOps portál folyamatáttekintő oldalán található URL-címről is lekérhető. A következő URL-példában a definitionId 78 https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary: . Ha egy adott folyamatdefinícióból szeretne összetevőket letölteni, rögzítse a definitionId folyamatot, és adja meg paraméterként pipeline .

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 be van jelölve, a feladat letölti az összetevőket az eseményindító buildből. Ha a megadott folyamatból nem aktivál buildet, a feladat letölti az összetevőket az alábbi beállításokban megadott buildből.

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.

A letölteni kívánt buildverziót adja meg.

branchName - Ág neve
string. Akkor szükséges, ha buildType == specific && buildVersionToDownload == latestFromBranch. Alapértelmezett érték: refs/heads/master.

Megadja a szűrőt az ág/hiv neve alapján. Példa: refs/heads/develop.

pipelineId - Épít
Bemeneti alias: buildId. string. Akkor szükséges, ha buildType == specific && buildVersionToDownload == specific.

Annak a folyamatnak az azonosítója, amelyből le szeretné tölteni az összetevőket. A futó folyamatokban a buildIdBuild.BuildId változóban található. A buildId az Azure DevOps portál folyamatfuttatási összefoglaló oldalán található URL-címről is lekérhető. A következő URL-példában a buildId 1088 a következő: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Ha egy adott folyamatfuttatásból szeretne összetevőket letölteni, rögzítse a parancsot a buildId futtatásból, és adja meg paraméterként buildId .

tags - Buildcímkék
string. Választható. Használja a következőt: buildType == specific && buildVersionToDownload != specific.

Azoknak a címkéknek a vesszővel tagolt listája, amelyeket a feladat a címkézett buildek visszaadására használ. A rendszer nem adja vissza a címkézés nélküli buildeket.

artifactName - Összetevő neve
string.

Megadja a letölteni kívánt összetevő nevét. Ha az érték üres, a tevékenység letölti a folyamatfuttatáshoz társított összes összetevőt.

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

A letöltött fájlokat korlátozó fájlegyeztetési minták. Az érték lehet egy vagy több fájlegyeztetési minta, amelyek új sorokat tagoltak. További információ a fájlegyeztetési mintákról.

targetPath - Célkönyvtár
Bemeneti alias: downloadPath. string. Kötelező. Alapértelmezett érték: $(System.ArtifactsDirectory).

Az ügynökgép elérési útja, ahol az összetevők le lesznek töltve.

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

Nincsenek.

Megjegyzések

A feladatnak van egy újabb verziója. További információ: DownloadPipelineArtifact@2.

Fontos

Ez a feladat csak az Azure DevOps Servicesben támogatott. Ha Azure DevOps Server használja, a buildösszetevők letöltése funkcióhoz Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. hasonló hibaüzenet jelenik meg Azure DevOps Server vagy TFS 2018 használata esetén.

Alapértelmezés szerint a rendszer letölti az összetevőket a fájlba $(Pipeline.Workspace). Ha nem ad meg összetevőnevet, minden letöltött összetevőhöz létrejön egy alkönyvtár. A fájlegyeztetési minták használatával korlátozhatja a letölteni kívánt fájlokat.

Hogyan találhatom meg annak a folyamatnak az azonosítóját, amelyből le szeretnék tölteni egy összetevőt?

Adott folyamatdefiníció definícióazonosítójának megkeresése

Egy futó folyamatban a definitionId a System.DefinitionId változóban található. A definitionId az Azure DevOps portál folyamatáttekintő oldalán található URL-címről is lekérhető. A következő URL-példában a definitionId 78 https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary: . Ha egy adott folyamatdefinícióból szeretne összetevőket letölteni, rögzítse a definitionId folyamatot, és adja meg paraméterként pipeline .

Egy adott folyamatfuttatás buildazonosítójának megkeresése

Annak a folyamatnak az azonosítója, amelyből le szeretné tölteni az összetevőket. A futó folyamatokban a buildIdBuild.BuildId változóban található. A buildId az Azure DevOps portál folyamatfuttatási összefoglaló oldalán található URL-címről is lekérhető. A következő URL-példában a buildId 1088 a következő: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Ha egy adott folyamatfuttatásból szeretne összetevőket letölteni, rögzítse a parancsot a buildId futtatásból, és adja meg paraméterként buildId .

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.155.1 vagy újabb
Feladatkategória	Segédprogram