DownloadPipelineArtifact@2 - Pijplijnartefacten v2-taak downloaden

Gebruik deze taak om pijplijnartefacten uit eerdere fasen in deze pijplijn of uit een andere pijplijn te downloaden.

Notitie

Zie Artefacten downloaden voor meer informatie, waaronder Azure CLI-opdrachten.

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

Invoerwaarden

buildType - Artefacten downloaden die zijn geproduceerd door
Invoeralias: source. string. Vereist. Toegestane waarden: current (Huidige uitvoering), specific (Specifieke uitvoering). Standaardwaarde: current.

Hiermee downloadt u artefacten die zijn geproduceerd door de huidige pijplijnuitvoering of van een specifieke pijplijnuitvoering.

project - Project
string. Vereist wanneer source == specific.

Hiermee geeft u de projectnaam of GUID van waaruit de pijplijnartefacten te downloaden.

definition - Build-pijplijn
Invoeralias: pipeline. string. Vereist wanneer source == specific.

De definitie-id van de pijplijn. In een actieve pijplijn vindt u de definitionId in de variabele System.DefinitionId . De definitionId kan ook worden opgehaald uit de URL op de overzichtspagina van de pijplijn in de Azure DevOps-portal. In het volgende URL-voorbeeld is de definitionId 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Als u artefacten wilt downloaden van een specifieke pijplijndefinitie, legt u de definitionId van die pijplijn vast en geeft u deze op als de pipeline parameter.

specificBuildWithTriggering - Download, indien van toepassing, artefacten uit de activerende build.
Invoeralias: preferTriggeringPipeline. boolean. Optioneel. Gebruik wanneer source == specific. Standaardwaarde: false.

Als deze optie is ingeschakeld, downloadt de taak artefacten uit de activerende build. Als er geen build wordt geactiveerd vanuit de opgegeven pijplijn, downloadt de taak artefacten van de build die is opgegeven in de onderstaande opties.

buildVersionToDownload - Buildversie om te downloaden
Invoeralias: runVersion. string. Vereist wanneer source == specific. Toegestane waarden: latest, latestFromBranch (Meest recente van specifieke vertakking en opgegeven buildtags), specific (specifieke versie). Standaardwaarde: latest.

Hiermee geeft u de buildversie te downloaden.

branchName - Naam van vertakking
Invoeralias: runBranch. string. Vereist wanneer source == specific && runVersion == latestFromBranch. Standaardwaarde: refs/heads/master.

Hiermee geeft u het filter op de naam van de vertakking/verw. Bijvoorbeeld: refs/heads/develop.

pipelineId - Bouwen
Invoeralias: runId | buildId. string. Vereist wanneer source == specific && runVersion == specific.

De id van de pijplijnuitvoering waaruit de artefacten moeten worden gedownload. In een actieve pijplijn vindt u de buildId in de variabele Build.BuildId . De buildId kan ook worden opgehaald uit de URL op de overzichtspagina van de pijplijnuitvoering in de Azure DevOps-portal. In het volgende URL-voorbeeld is de buildId 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Als u artefacten wilt downloaden van een specifieke pijplijnuitvoering, legt u de buildId van die uitvoering vast en geeft u deze op als de buildId parameter.

tags - BuildTags
string. Optioneel. Gebruik wanneer source == specific && runVersion != specific.

De door komma's gescheiden lijst met tags die de taak gebruikt om getagde builds te retourneren. Builds zonder tag worden niet geretourneerd.

allowPartiallySucceededBuilds - Artefacten downloaden van gedeeltelijk geslaagde builds.
boolean. Optioneel. Gebruik wanneer source == specific && runVersion != specific. Standaardwaarde: false.

Hiermee geeft u op of de build-taak artefacten downloadt of de build slaagt of gedeeltelijk slaagt.

allowFailedBuilds - Artefacten downloaden van mislukte builds.
boolean. Optioneel. Gebruik wanneer source == specific && runVersion != specific. Standaardwaarde: false.

Als deze optie is ingeschakeld, downloadt de build-taak artefacten, ongeacht of de build slaagt of mislukt.

artifactName - Naam van artefact
Invoeralias: artifact. string.

Hiermee geeft u de naam van het artefact te downloaden. Als de waarde leeg blijft, downloadt de taak alle artefacten die zijn gekoppeld aan de pijplijnuitvoering.

itemPattern - Overeenkomende patronen
Invoeralias: patterns. string. Standaardwaarde: **.

De bestandsmatchpatronen die gedownloade bestanden beperken. De waarde kan een of meer overeenkomende bestandspatronen zijn die zijn gescheiden door nieuwe regels. Meer informatie over patronen voor het vergelijken van bestanden.

targetPath - Doelmap
Invoeralias: path | downloadPath. string. Vereist. Standaardwaarde: $(Pipeline.Workspace).

Hiermee geeft u een relatief of absoluut pad op de agentcomputer op waar de artefacten worden gedownload. Als de optie voor meerdere downloads wordt toegepast (door een lege artefactnaam achter te laten), wordt voor elke download een submap gemaakt. Meer informatie over artefacten in Azure Pipelines.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Deze taak definieert de volgende uitvoervariabelen, die u kunt gebruiken in downstreamstappen, taken en fasen.

BuildNumber
Hiermee wordt het buildnummer van de bron van het pijplijnartefact opgeslagen.

Vanwege compatibiliteit met eerdere versies retourneert deze variabele BuildId.

Meer informatie over buildvariabelen.

Opmerkingen

Belangrijk

Deze taak wordt alleen ondersteund in Azure DevOps Services. Als u deze gebruikt op Azure DevOps Server, ontvangt u een foutbericht dat vergelijkbaar is met Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead.Download Build Artifacts gebruiken als u Azure DevOps Server of TFS 2018 gebruikt.

Gebruik deze taak om pijplijnartefacten uit eerdere fasen in deze pijplijn of uit een andere pijplijn te downloaden. Artefacten worden standaard gedownload naar $(Pipeline.Workspace). Als u geen artefactnaam opgeeft, wordt er een submap gemaakt voor elk gedownload artefact. U kunt patronen voor het vergelijken van bestanden gebruiken om de bestanden te beperken die u wilt downloaden.

De trefwoorden publiceren en downloaden zijn snelkoppelingen voor taken om uw pijplijnartefacten te publiceren en te downloaden .

Hoe kan ik de id vinden van de pijplijn waarvan ik een artefact wil downloaden?

De definitionId voor een specifieke pijplijndefinitie zoeken

In een actieve pijplijn vindt u de definitionId in de variabele System.DefinitionId . De definitionId kan ook worden opgehaald uit de URL op de overzichtspagina van de pijplijn in de Azure DevOps-portal. In het volgende URL-voorbeeld is de definitionId 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Als u artefacten wilt downloaden van een specifieke pijplijndefinitie, legt u de definitionId vast uit die pijplijn en geeft u deze op als de pipeline parameter.

De buildId voor een specifieke pijplijn uitvoeren

De id van de pijplijnuitvoering waaruit de artefacten moeten worden gedownload. In een actieve pijplijn vindt u de buildId in de variabele Build.BuildId . De buildId kan ook worden opgehaald uit de URL op de overzichtspagina van de pijplijnuitvoering in de Azure DevOps-portal. In het volgende URL-voorbeeld is de buildId 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Als u artefacten wilt downloaden van een specifieke pijplijnuitvoering, legt u de buildId van die uitvoering vast en geeft u deze op als de buildId parameter.

Voorbeelden

Een specifiek artefact downloaden

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

Artefacten downloaden van een specifiek project/pijplijn

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

Artefacten downloaden van een specifieke vertakking

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

Een artefact downloaden van een specifieke build-uitvoering

# 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

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	2.164.1 of hoger
Taakcategorie	Hulpprogramma