DownloadPipelineArtifact@2 – Folyamatösszetevők v2-feladat letöltése

Cikk
07/02/2024

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

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.

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

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.

Syntax

# Download Pipeline Artifacts v2
# Download build and pipeline artifacts.
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'current' # 'current' | 'specific'. Alias: source. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when source == specific. Project. 
    #definition: # string. Alias: pipeline. Required when source == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Alias: preferTriggeringPipeline. Optional. Use when source == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Alias: runVersion. Required when source == specific. Build version to download. Default: latest.
    #branchName: 'refs/heads/master' # string. Alias: runBranch. Required when source == specific && runVersion == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: runId | buildId. Required when source == specific && runVersion == specific. Build. 
    #tags: # string. Optional. Use when source == specific && runVersion != specific. Build Tags. 
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from partially succeeded builds. Default: false.
    #allowFailedBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from failed builds. Default: false.
    #artifactName: # string. Alias: artifact. Artifact name. 
    #itemPattern: '**' # string. Alias: patterns. Matching patterns. Default: **.
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path | downloadPath. Required. Destination directory. Default: $(Pipeline.Workspace).

Bevitelek

buildType - Az által előállított összetevők letöltése
Bemeneti alias: source. string. Kötelező. Engedélyezett értékek: current (Aktuális futtatás), specific (Adott futtatás). 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 source == specific.

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

definition - Folyamat létrehozása
Bemeneti alias: pipeline. string. Akkor szükséges, ha source == 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.
Bemeneti alias: preferTriggeringPipeline. boolean. Választható. Használja a következőt: source == 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ó
Bemeneti alias: runVersion. string. Akkor szükséges, ha source == 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
Bemeneti alias: runBranch. string. Akkor szükséges, ha source == specific && runVersion == 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: runId | buildId. string. Akkor szükséges, ha source == specific && runVersion == 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: source == specific && runVersion != 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.

allowPartiallySucceededBuilds - Összetevők letöltése részben sikeres buildekből.
boolean. Választható. Használja a következőt: source == specific && runVersion != specific. Alapértelmezett érték: false.

Megadja, hogy a buildelési feladat letölti-e az összetevőket, hogy a build sikeres vagy részlegesen sikeres-e.

allowFailedBuilds - Összetevők letöltése sikertelen buildekből.
boolean. Választható. Használja a következőt: source == specific && runVersion != specific. Alapértelmezett érték: false.

Ha be van jelölve, a buildelési feladat letölti az összetevőket, függetlenül attól, hogy a build sikeres vagy sikertelen-e.

artifactName - Összetevő neve
Bemeneti alias: artifact. 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ő minták
Bemeneti alias: patterns. 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: path | downloadPath. string. Kötelező. Alapértelmezett érték: $(Pipeline.Workspace).

Relatív vagy abszolút elérési utat ad meg azon az ügynökgépen, ahol az összetevők le lesznek töltve. Ha a többszörös letöltési beállítást alkalmazza (üres összetevőnév meghagyásával), minden letöltéshez létrejön egy alkönyvtár. További információ az Azure Pipelines összetevőiről.

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 folyamatösszetevő forrásának buildszámát tárolja.

A visszamenőleges kompatibilitás miatt ez a változó a BuildId értéket adja vissza.

További információ a buildváltozókról.

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 folyamatösszetevő forrásának buildszámát tárolja.

Megjegyzések

Fontos

Ezzel a feladatsal folyamatösszetevőket tölthet le a folyamat korábbi szakaszaiból vagy egy másik folyamatból. 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.

A közzétételi és letöltési kulcsszavak a folyamatösszetevők közzétételének és letöltésének parancsikonjai.

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

Példák

Adott összetevő letöltése

# Download an artifact named 'WebApp' to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
  inputs:
    artifactName: 'WebApp'
    targetPath: $(Build.SourcesDirectory)/bin

Összetevők letöltése egy adott projektből/folyamatból

# Download artifacts from a specific pipeline.
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'latest'

Összetevők letöltése egy adott ágból

# Download artifacts from a specific branch with a tag
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'latestFromBranch'
    branchName: 'refs/heads/master'
    tags: 'testTag'

Összetevő letöltése egy adott buildfuttatásból

# Download an artifact named 'WebApp' from a specific build run to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    artifactName: 'WebApp'
    targetPath: $(Build.SourcesDirectory)/bin
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'specific'
    pipelineId: 40

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

Megosztás a következőn keresztül: