DownloadPipelineArtifact@1 - Pijplijnartefact v1-taak downloaden

Artikel
03/24/2025

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

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

Notitie

Zie artefacten downloadenvoor meer informatie, waaronder Azure CLI-opdrachten.

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

Belangrijk

Deze taak wordt alleen ondersteund in Azure DevOps Services. Als u deze gebruikt op Azure DevOps Server, krijgt u een foutbericht dat lijkt op Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Gebruik Build-artefacten downloaden als u Azure DevOps Server of TFS 2018 gebruikt.

Syntaxis

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

Invoer

buildType - artefacten downloaden die zijn geproduceerd door
string. Verplicht. Toegestane waarden: current (huidige build), specific (specifieke build). Standaardwaarde: current.

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

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

Hiermee geeft u de projectnaam of GUID 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 van een specifieke pijplijndefinitie wilt downloaden, legt u de definitionId van die pijplijn vast en geeft u deze op als de parameter pipeline.

specificBuildWithTriggering - , indien van toepassing, downloadt u artefacten uit de triggerende build.
boolean. Facultatief. Gebruiken wanneer buildType == specific. Standaardwaarde: false.

Als dit is ingeschakeld, downloadt de taak artefacten uit de triggerende build. Als er geen build wordt geactiveerd vanuit de opgegeven pijplijn, downloadt de taak artefacten uit de build die is opgegeven in de onderstaande opties.

buildVersionToDownload - Build-versie om te downloaden
string. Vereist wanneer buildType == specific. Toegestane waarden: latest, latestFromBranch (meest recente versie van specifieke vertakking en opgegeven buildtags), specific (specifieke versie). Standaardwaarde: latest.

Hiermee geeft u de buildversie die moet worden gedownload.

branchName - branchnaam
string. Vereist wanneer buildType == specific && buildVersionToDownload == latestFromBranch. Standaardwaarde: refs/heads/master.

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

pipelineId - Build
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 parameter buildId.

tags - tags maken
string. Facultatief. Gebruiken wanneer buildType == specific && buildVersionToDownload != specific.

De door komma's gescheiden lijst met tags die door de taak worden gebruikt om getagde builds te retourneren. Niet-gemarkeerde builds worden niet geretourneerd.

naam van artifactName - artefact
string.

Hiermee geeft u de naam van het artefact dat moet worden gedownload. Als de waarde leeg blijft, downloadt de taak alle artefacten die zijn gekoppeld aan de pijplijnuitvoering.

itemPattern - overeenkomende patroon
string. Standaardwaarde: **.

De bestandskoppelingspatronen waarmee gedownloade bestanden worden beperkt. De waarde kan een of meer bestandskoppelingspatronen zijn die nieuwe regelscheidingstekens bevatten. Meer informatie over bestandskoppelingspatronen.

targetPath - doelmap
Invoeralias: downloadPath. string. Verplicht. 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 en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

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

Belangrijk

Artefacten worden standaard gedownload naar $(Pipeline.Workspace). Als u geen artefactnaam opgeeft, wordt er een submap gemaakt voor elk gedownload artefact. U kunt bestandskoppelingspatronen gebruiken om de bestanden te beperken die u wilt downloaden.

Hoe vind ik de id van de pijplijn waaruit 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 van een specifieke pijplijndefinitie wilt downloaden, legt u de definitionId van die pijplijn vast en geeft u deze op als de parameter pipeline.

De buildId voor een specifieke pijplijnuitvoering zoeken

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	2.155.1 of hoger
Taakcategorie	Nutsvoorzieningen

Delen via