Megosztás:

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

Ezzel a tevékenységgel letöltheti a folyamat összetevőit 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 összetevők letöltését.

Ezzel a tevékenységgel letöltheti a folyamat összetevőit a folyamat korábbi szakaszaiból vagy egy másik folyamatból.

Fontos

Ez a feladat csak az Azure DevOps Servicesben támogatott. Ha az Azure DevOps Serveren használja, akkor az Azure DevOps Server vagy a TFS 2018 használata esetén a Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. hasonló hibaüzenet jelenik meg.

Szemantika

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

Bemenetek

buildType - által előállított összetevők letöltése
Bemeneti alias: source. string. Szükséges. 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. source == specificesetén kötelező.

Megadja azt a projektnevet vagy GUID-t, amelyből le szeretné tölteni a folyamatösszetevőket.


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

A folyamat definícióazonosítója. 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 összetevőket szeretne letölteni egy adott folyamatdefinícióból, rögzítse a definitionId a folyamatból, és adja meg pipeline paraméterként.


specificBuildWithTriggering - Adott esetben töltse le az összetevőket az eseményindító buildből.
Bemeneti alias: preferTriggeringPipeline. boolean. Opcionális. Használja a 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 nincs aktiváló build a megadott folyamatból, a tevékenység letölti az összetevőket az alábbi beállításokban megadott buildből.


buildVersionToDownload - buildverzió letöltése
Bemeneti alias: runVersion. string. source == 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.

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


branchName - ágnév
Bemeneti alias: runBranch. string. source == specific && runVersion == latestFromBranchesetén kötelező. Alapértelmezett érték: refs/heads/master.

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


pipelineId - Összeállítás
Bemeneti alias: runId | buildId. string. source == specific && runVersion == specificesetén kötelező.

Annak a folyamatnak az azonosítója, amelyből le szeretné tölteni az összetevőket. Futó folyamatban a buildId a Build.BuildId változóban található. A buildId az Azure DevOps portál folyamatfuttatási összefoglaló lapján található URL-címről is lekérhető. Az alábbi URL-példában a buildId 1088: 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 buildId az adott futtatásból, és adja meg buildId paraméterként.


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

A tevékenység által a címkével ellátott buildek visszaadásához használt címkék vesszővel tagolt listája. A rendszer nem adja vissza a nem megjelölt buildeket.


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

Meghatározza, hogy a részben sikeres buildekből letöltse-e az összetevőket. Ehhez mindkettőt be kell állítaniaallowPartiallySucceededBuilds.allowFailedBuildstrue


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

Meghatározza, hogy le szeretné-e tölteni az összetevőket a sikertelen buildekből.


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ájlmegfeleltetési minták. Az érték lehet egy vagy több fájlegyeztetési minta, amely új sorokat tagolt. További információ fájlegyeztetési mintákról.

Más feladatoktól eltérően ez a feladat letölt egy fájlt, amely bármilyen mintának megfelel. A kizárási minták nem használhatók a korábban belefoglalt fájlok kizárására, és olyan fájlokat tartalmaznak, amelyek nem felelnek meg a belefoglalási mintáknak.


targetPath - Célkönyvtár
Bemeneti alias: path | downloadPath. string. Szükséges. 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öbbletöltéses beállítást alkalmazza (üres összetevőnév elhagyá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
Tárolja a folyamatösszetevő-forrás buildszámát.

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

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

Megjegyzések

Fontos

Ez a feladat csak az Azure DevOps Servicesben támogatott. Ha az Azure DevOps Serveren használja, akkor az Azure DevOps Server vagy a TFS 2018 használata esetén a Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. hasonló hibaüzenet jelenik meg.

Ezzel a tevékenységgel letöltheti a folyamat összetevőit a folyamat korábbi szakaszaiból vagy egy másik folyamatból. Alapértelmezés szerint a rendszer letölti az összetevőket a következőre $(Pipeline.Workspace): . Ha nem ad meg összetevőnevet, minden letöltött összetevőhöz létrejön egy alkönyvtár. A letölteni kívánt fájlok korlátozásához fájlmegfeleltetési mintákat használhat.

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álom 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

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 összetevőket szeretne letölteni egy adott folyamatdefinícióból, rögzítse a definitionId a folyamatból, és adja meg pipeline paraméterként.

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. Futó folyamatban a buildId a Build.BuildId változóban található. A buildId az Azure DevOps portál folyamatfuttatási összefoglaló lapján található URL-címről is lekérhető. Az alábbi URL-példában a buildId 1088: 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 buildId az adott futtatásból, és adja meg buildId paraméterként.

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 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.164.1 vagy újabb
Tevékenységkategória Hasznosság
  • Last updated on