DownloadBuildArtifacts@1 - Télécharger la tâche de compilation des artefacts v1

Utilisez cette tâche pour télécharger des fichiers 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 les artefacts de pipeline et publier des artefacts de pipeline pour accélérer les performances.

Syntaxe

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

Données d'entrée

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.

Indique s’il faut télécharger des artefacts générés par la build actuelle ou à partir d’une build spécifique.

project - project
string. Obligatoire lorsque buildType == specific.

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

pipeline - de pipeline de génération
Alias d’entrée : definition. string. Obligatoire lorsque buildType == specific.

Spécifie le nom du pipeline de build.

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

Si true, cette tâche de génération tente de télécharger des artefacts à partir de la build de déclenchement. S’il n’existe aucun 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.

version de build buildVersionToDownload - pour télécharger
string. Obligatoire 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 des balises spécifiées par tags.
• Choisissez specific de télécharger la version de build spécifiée par buildId.

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

Si true, cette tâche de génération tente de télécharger des artefacts si la build réussit ou échoue partiellement.

branchName - nom de branche
string. Obligatoire lorsque buildType == specific && buildVersionToDownload == latestFromBranch. Valeur par défaut : refs/heads/master.

Spécifie s’il faut filtrer le nom de branche/ref, par exemple : refs/heads/develop.

buildId - Générer
string. Obligatoire lorsque buildType == specific && buildVersionToDownload == specific.

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

tags - générer des étiquettes
string. Optionnel. Utilisez quand buildType == specific && buildVersionToDownload != specific.

Liste délimitée par des virgules de balises. 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 spécifique ou des fichiers spécifiques à partir de la build.

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

nom d’artefact artifactName -
string. Obligatoire 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 mini-correspondance à plusieurs lignes. 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 liste déroulante d’artefacts, utilisez drop/**.

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

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

Pour plus d’informations sur System.ArtifactsDirectory, consultez Utiliser des variables dans les pipelines de mise en production classique.

cleanDestinationFolder - dossier de destination Propre
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 true, 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 en cas d’échec du téléchargement.

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 portant l’extension .tar . C’est utile car vous devez emballer vos fichiers d’artefacts dans tar si vous souhaitez conserver les permissions des fichiers Unix. L’activation de l’option StoreAsTar dans la tâche Publier les artefacts de build stockera 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 en aval, les travaux et les étapes.

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

Remarque

L’équipe Azure Pipelines recommande de passer des artefacts de build aux artefacts de pipeline pour des performances plus rapides.

Spécifications

Besoin	Descriptif
Types de pipelines	YAML, Build Classique, Version Classique
Exécutions sur	Agent, DeploymentGroup
Demandes	Aucun
Capacités	Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande	N'importe lequel
Variables settables	N'importe lequel
Version de l’agent	2.191.1 ou version ultérieure
Catégorie de tâche	Utilité