DownloadBuildArtifacts@0 - Tâche Télécharger les artefacts de build v0

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

Notes

Désactivez l’authentification de base IIS si vous utilisez Azure DevOps Server pour autoriser l’authentification avec votre jeton d’accès personnel. Pour plus d’informations, consultez Authentification de base et PAT IIS.

Téléchargez Build Artifacts.

Syntax

# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
  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.
    #retryRedirectDownloadCount: '0' # string. Retry count for redirect download. Default: 0.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
  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.

# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
  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).
  # Advanced
    #parallelizationLimit: '8' # string. Parallelization limit. Default: 8.

# Download Build Artifacts v0
# Download Build Artifacts.
- task: DownloadBuildArtifacts@0
  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.
    #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).
  # Advanced
    #parallelizationLimit: '8' # string. Parallelization limit. Default: 8.

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 vous souhaitez 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.


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.


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.

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


retryRedirectDownloadCount - Nombre de nouvelles tentatives pour le téléchargement de redirection
string. Valeur par défaut : 0.

Nombre facultatif de tentatives de téléchargement d’un artefact de build si le téléchargement basé sur la redirection échoue. Si votre réseau n’autorise pas le suivi de la redirection, vous pouvez définir cette valeur sur -1 pour toujours télécharger la réponse diffusée à partir d’Azure DevOps à la place.


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

Extrait tous les fichiers téléchargés qui ont une .tar extension. Cela est utile, car vous devez emballer vos fichiers d’artefact dans un .tar fichier si vous souhaitez conserver les autorisations de fichier Unix. L’activation de l’option StoreAsTar dans la tâche PublishBuildArtifacts stocke automatiquement les artefacts sous forme de .tar fichiers.


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.

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.

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 commande Quelconque
Variables paramétrables Quelconque
Version de l’agent Toutes les versions d’agent prises en charge.
Catégorie de la tâche Utilitaire