DownloadBuildArtifacts@1 - Tâche Télécharger les artefacts de build v1

  • Article

Utilisez cette tâche pour télécharger des fichiers qui ont été enregistrés en tant qu’artefacts d’une build terminée.

Si vous utilisez Azure DevOps Services, nous vous recommandons d’utiliser Télécharger des artefacts de pipeline et Publier des artefacts de pipeline pour des performances plus rapides.

Syntax

# Download build artifacts v1
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@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.
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
    artifactName: # string. Required when downloadType == single. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
    #cleanDestinationFolder: false # boolean. Clean destination folder. Default: false.
  # Advanced
    #parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
    #checkDownloadedFiles: false # boolean. Check downloaded files. Default: false.
    #retryDownloadCount: '4' # string. Retry count. Default: 4.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

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.

Si vous souhaitez télécharger des artefacts produits par la build actuelle ou à partir d’une build spécifique.


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

Projet à partir duquel télécharger les artefacts de build.


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

Spécifie le nom du pipeline de build.


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

Si la valeur est true, cette tâche de build tente de télécharger des artefacts à partir de la build qui déclenche. S’il n’y a pas de déclencheur de build à partir du pipeline spécifié, il 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 la build à télécharger.

  • Choisissez latest de télécharger la dernière version de build disponible.
  • Choisissez latestFromBranch de télécharger la dernière version de build disponible de la branche spécifiée par branchName et les balises spécifiées par tags.
  • Choisissez specific de télécharger la version de build spécifiée par buildId.

allowPartiallySucceededBuilds - Téléchargez des artefacts même à partir de builds partiellement réussies.
boolean. facultatif. Utilisez quand buildType == specific && buildVersionToDownload != specific. Valeur par défaut : false.

Si la valeur est true, cette tâche de build tente de télécharger des artefacts, que la build réussisse ou réussit partiellement.


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

Spécifie s’il faut filtrer sur le nom de la branche/de la référence, par exemple : refs/heads/develop.


buildId - Construire
string. Nécessaire lorsque buildType == specific && buildVersionToDownload == specific.

Build à partir de laquelle vous souhaitez télécharger les artefacts.


tags - Balises de génération
string. facultatif. Utilisez quand buildType == specific && buildVersionToDownload != specific.

Liste de balises délimitées par des virgules. Seules les builds avec ces balises sont retournées.


downloadType - Type de téléchargement
string. Obligatoire. Valeurs autorisées : single (artefact spécifique), specific (fichiers spécifiques). Valeur par défaut : single.

Télécharge un artefact ou des fichiers spécifiques à partir de la build.

  • Choisissez single (Artefact spécifique) lorsque vous souhaitez qu’un seul artefact spécifique spécifié par artifactName
  • Choisissez specific (Fichiers spécifiques) quand vous souhaitez tous les artefacts de la build sélectionnée

artifactName - Nom de l’artefact
string. Nécessaire lorsque downloadType == single.

Nom de l’artefact à télécharger.


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

Spécifie les fichiers à télécharger sous la forme d’un modèle de mini-correspondance multiligne. Pour plus d’informations, consultez Informations de référence sur les modèles de correspondance de fichiers.

Le modèle \*\* par défaut télécharge tous les fichiers sur tous les artefacts de la build si vous choisissez l’option Fichiers spécifiques . Pour télécharger tous les fichiers dans la suppression de l’artefact, utilisez drop/**.


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

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


cleanDestinationFolder - Nettoyer le dossier de destination
boolean. Valeur par défaut : false.

Supprimez tous les fichiers existants dans le dossier de destination avant le téléchargement de l’artefact.


parallelizationLimit - Limite de parallélisation
string. Valeur par défaut : 8.

Nombre de fichiers à télécharger simultanément.


checkDownloadedFiles - Vérifier les fichiers téléchargés
boolean. Valeur par défaut : false.

Si truela valeur est , cette tâche de génération vérifie que tous les fichiers sont entièrement téléchargés.


retryDownloadCount - Nombre de nouvelles tentatives
string. Valeur par défaut : 4.

Nombre de tentatives de téléchargement d’un artefact de build si le téléchargement échoue.


extractTars - Extraire tous les fichiers stockés dans les archives tar
boolean.

Définissez sur true pour extraire tous les fichiers téléchargés qui ont l’extension .tar . Cela est utile, car vous devez emballer vos fichiers d’artefact dans tar si vous souhaitez conserver les autorisations de fichier Unix. L’activation de l’option StoreAsTar dans la tâche Publier les artefacts de build stocke automatiquement les artefacts sous forme de fichiers .tar .


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

Cette tâche définit les variables de sortie suivantes, que vous pouvez utiliser dans les étapes, les travaux et les étapes en aval.

BuildNumber
Stocke le numéro de build de la source de l’artefact de build.

Notez que cette entrée retourne BuildId en raison de la compatibilité descendante. Pour plus d’informations, consultez Variables.

Remarques

Notes

L’équipe Azure Pipelines recommande la mise à niveau des artefacts de build vers les artefactsde pipeline pour des performances plus rapides.

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.191.1 ou version ultérieure
Catégorie de la tâche Utilitaire