DownloadPipelineArtifact@1 - Pijplijnartefact v1-taak downloaden

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

Er is een nieuwere versie van deze taak. Zie DownloadPipelineArtifact@2 voor meer informatie.

Notitie

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

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

Invoerwaarden

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

Downloadt artefacten die zijn geproduceerd door de huidige pijplijnuitvoering of van een specifieke pijplijnuitvoering.

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

Hiermee geeft u de projectnaam of GUID op van waaruit de pijplijnartefacten moeten worden gedownload.

pipeline - Build-pijplijn
Invoeralias: definition. string. Vereist wanneer buildType == 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 vast uit die pijplijn en geeft u deze op als de pipeline parameter.

specificBuildWithTriggering - Download, indien van toepassing, artefacten van de activerende build.
boolean. Optioneel. Gebruik wanneer buildType == 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
string. Vereist wanneer buildType == 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
string. Vereist wanneer buildType == specific && buildVersionToDownload == latestFromBranch. Standaardwaarde: refs/heads/master.

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

pipelineId - Bouwen
Invoeralias: buildId. string. Vereist wanneer buildType == specific && buildVersionToDownload == 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 buildType == specific && buildVersionToDownload != specific.

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

artifactName - Naam van artefact
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 - Overeenkomend patroon
string. Standaardwaarde: **.

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

targetPath - Doelmap
Invoeralias: downloadPath. string. Vereist. Standaardwaarde: $(System.ArtifactsDirectory).

Het pad op de agentcomputer waar de artefacten worden gedownload.

Opties voor taakbeheer

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

Uitvoervariabelen

Geen.

Opmerkingen

Er is een nieuwere versie van deze taak. Zie DownloadPipelineArtifact@2 voor meer informatie.

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.

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.

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.

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.155.1 of hoger
Taakcategorie	Hulpprogramma