DownloadPipelineArtifact@1 - Tâche télécharger l’artefact de pipeline v1

Utilisez cette tâche pour télécharger des artefacts de pipeline à partir des étapes antérieures de ce pipeline ou d’un autre pipeline.

Il existe une version plus récente de cette tâche. Pour plus d’informations, consultez DownloadPipelineArtifact@2.

Notes

Pour plus d’informations, notamment les commandes Azure CLI, consultez téléchargement d’artefacts.

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

Entrées

buildType - Télécharger les artefacts produits par
string. Obligatoire. Valeurs autorisées : current (Build actuelle), specific (Build spécifique). Valeur par défaut : current.

Télécharge les artefacts produits par l’exécution du pipeline en cours ou à partir d’une exécution de pipeline spécifique.

project - Projet
string. Nécessaire lorsque buildType == specific.

Spécifie le nom du projet ou le GUID à partir duquel télécharger les artefacts de pipeline.

pipeline - Pipeline de build
Alias d’entrée : definition. string. Nécessaire lorsque buildType == specific.

ID de définition du pipeline. Dans un pipeline en cours d’exécution, le definitionId se trouve dans la variable System.DefinitionId . Peut definitionId également être récupéré à partir de l’URL de la page de vue d’ensemble du pipeline dans le portail Azure DevOps. Dans l’exemple d’URL suivant, est definitionId 78 : https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Pour télécharger des artefacts à partir d’une définition de pipeline spécifique, capturez le definitionId à partir de ce pipeline et spécifiez-le pipeline en tant que paramètre.

specificBuildWithTriggering - Le cas échéant, téléchargez les artefacts à partir de la build de déclenchement.
boolean. facultatif. Utilisez quand buildType == specific. Valeur par défaut : false.

Si cette option est cochée, la tâche télécharge les artefacts à partir de la build de déclenchement. Si aucune build n’est déclenchée à partir du pipeline spécifié, la tâche télécharge les artefacts à partir de la build spécifiée dans les options ci-dessous.

buildVersionToDownload - Version de build à télécharger
string. Nécessaire lorsque buildType == specific. Valeurs autorisées : latest, latestFromBranch (Dernière version de la branche spécifique et balises de build spécifiées), specific (version spécifique). Valeur par défaut : latest.

Spécifie la version de build à télécharger.

branchName - Nom de la branche
string. Nécessaire lorsque buildType == specific && buildVersionToDownload == latestFromBranch. Valeur par défaut : refs/heads/master.

Spécifie le filtre sur le nom de branche/ref. Par exemple : refs/heads/develop.

pipelineId - Construire
Alias d’entrée : buildId. string. Nécessaire lorsque buildType == specific && buildVersionToDownload == specific.

Identificateur de l’exécution du pipeline à partir duquel télécharger les artefacts. Dans un pipeline en cours d’exécution, le buildId se trouve dans la variable Build.BuildId . Peut buildId également être récupéré à partir de l’URL de la page de résumé de l’exécution du pipeline dans le portail Azure DevOps. Dans l’exemple d’URL suivant, est buildId 1088 : https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Pour télécharger des artefacts à partir d’une exécution de pipeline spécifique, capturez le buildId à partir de cette exécution et spécifiez-le buildId en tant que paramètre.

tags - Balises de build
string. facultatif. Utilisez quand buildType == specific && buildVersionToDownload != specific.

Liste délimitée par des virgules des balises que la tâche utilise pour retourner des builds balisées. Les builds non marquées ne sont pas retournées.

artifactName - Nom de l’artefact
string.

Spécifie le nom de l’artefact à télécharger. Si la valeur est laissée vide, la tâche télécharge tous les artefacts associés à l’exécution du pipeline.

itemPattern - Modèle de correspondance
string. Valeur par défaut : **.

Modèles de correspondance de fichiers qui limitent les fichiers téléchargés. La valeur peut être un ou plusieurs modèles de correspondance de fichier délimités par une nouvelle ligne. En savoir plus sur les modèles de correspondance de fichiers.

targetPath - Répertoire de destination
Alias d’entrée : downloadPath. string. Obligatoire. Valeur par défaut : $(System.ArtifactsDirectory).

Chemin d’accès sur l’ordinateur de l’agent où les artefacts seront téléchargés.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Il existe une version plus récente de cette tâche. Pour plus d’informations, consultez DownloadPipelineArtifact@2.

Important

Cette tâche est prise en charge sur Azure DevOps Services uniquement. Si vous l’utilisez sur Azure DevOps Server, vous recevrez un message d’erreur similaire à Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Utiliser télécharger des artefacts de build si vous utilisez Azure DevOps Server ou TFS 2018.

Par défaut, les artefacts sont téléchargés dans $(Pipeline.Workspace). Si vous ne spécifiez pas de nom d’artefact, un sous-répertoire est créé pour chaque artefact téléchargé. Vous pouvez utiliser des modèles de correspondance de fichiers pour limiter les fichiers que vous souhaitez télécharger.

Comment trouver l’ID du pipeline à partir duquel je souhaite télécharger un artefact ?

Pour rechercher l’id de définition d’une définition de pipeline spécifique

Dans un pipeline en cours d’exécution, le definitionId se trouve dans la variable System.DefinitionId . Peut definitionId également être récupéré à partir de l’URL de la page de vue d’ensemble du pipeline dans le portail Azure DevOps. Dans l’exemple d’URL suivant, est definitionId 78 : https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Pour télécharger des artefacts à partir d’une définition de pipeline spécifique, capturez le definitionId à partir de ce pipeline et spécifiez-le pipeline en tant que paramètre.

Pour rechercher le buildId d’une exécution de pipeline spécifique

Identificateur de l’exécution du pipeline à partir duquel télécharger les artefacts. Dans un pipeline en cours d’exécution, le buildId se trouve dans la variable Build.BuildId . Peut buildId également être récupéré à partir de l’URL de la page de résumé de l’exécution du pipeline dans le portail Azure DevOps. Dans l’exemple d’URL suivant, est buildId 1088 : https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Pour télécharger des artefacts à partir d’une exécution de pipeline spécifique, capturez le buildId à partir de cette exécution et spécifiez-le buildId en tant que paramètre.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes	Quelconque
Variables settables	Quelconque
Version de l’agent	2.155.1 ou version ultérieure
Catégorie de la tâche	Utilitaire