ExtractFiles@1 - Extraire des fichiers v1

Utilisez cette tâche pour extraire une variété de fichiers d’archivage et de compression, tels que .7z, .rar, .tar.gz et .zip.

Syntaxe

# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip' # string. Required. Archive file patterns. Default: **/*.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
    #overwriteExistingFiles: false # boolean. Overwrite existing files. Default: false.
    #pathToSevenZipTool: # string. Path to 7z utility.

Entrées

archiveFilePatterns - modèles de fichier Archive
string. Obligatoire. Valeur par défaut : **/*.zip.

Spécifie les chemins d’accès ou les modèles de fichiers d’archive à extraire. Prend en charge plusieurs lignes de modèles de mini-correspondance. En savoir plus sur la tâche Extraire des fichiers.

Spécifie les modèles à extraire pour les archives que vous souhaitez extraire. Par défaut, les modèles commencent dans le dossier racine du référentiel (comme si vous aviez spécifié $(Build.SourcesDirectory).
Spécifie les filtres de modèle, un par ligne, qui correspondent aux archives à extraire. Par exemple:

• test.zip extrait le fichier test.zip dans le dossier racine.
• test/*.zip extrait tous les fichiers .zip dans le dossier de test.
• **/*.tar extrait tous les fichiers .tar dans le dossier racine et les sous-dossiers.
• **/bin/*.7z extrait tous les fichiers .7z dans n’importe quel sous-dossier nommé « bin ».

Le modèle est utilisé pour faire correspondre uniquement les chemins d’accès des fichiers d’archivage, et non les chemins d’accès aux dossiers et non le contenu d’archivage à extraire. Par conséquent, vous devez spécifier des modèles, tels que **/bin/** au lieu de **/bin.

Pour extraire des fichiers à partir d’autres chemins d’accès (par exemple, un artefact de pipeline), utilisez la tâche de copie pour copier le fichier que vous souhaitez extraire dans le dossier racine de votre dépôt : $(Build.SourcesDirectory). Par exemple, pour copier un artefact de pipeline, déplacez le fichier de $(Pipeline.Workspace) vers $(Build.SourcesDirectory), puis extrayez-le à partir du dossier racine ou de ses sous-dossiers.

destinationFolder - dossier de destination
string. Obligatoire.

Spécifie le dossier de destination dans lequel les fichiers d’archivage doivent être extraits. Utilisez variables si les fichiers ne figurent pas dans le référentiel. Par exemple : $(agent.builddirectory).

cleanDestinationFolder - dossier de destination Nettoyer avant d’extraire
boolean. Valeur par défaut : true.

Spécifie l’option permettant de supprimer l’intégralité du contenu du répertoire de destination (propre) avant l’extraction du contenu de l’archive.

overwriteExistingFiles - remplacer les fichiers existants
boolean. Valeur par défaut : false.

Spécifie l’option permettant de remplacer les fichiers existants dans le répertoire de destination s’ils existent déjà. Si l’option est false, le script invite les fichiers existants à les remplacer.

pathToSevenZipTool - Chemin d’accès à l’utilitaire 7z
string.

Spécifie le chemin d’accès personnalisé à l’utilitaire 7z. Par exemple, C:\7z\7z.exe sur Windows et /usr/local/bin/7z sur MacOS/Ubuntu. S’il n’est pas spécifié sur Windows, la version 7zip par défaut fournie avec une tâche sera utilisée.

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.

Remarques

Utilisez cette tâche pour extraire des fichiers d’archives vers un dossier cible à l’aide de modèles de correspondance. Une gamme de formats d’archive standard est prise en charge, notamment .zip, .jar, .war, .ear, .tar, .7z, etc.

Pour plus d’informations sur les modèles de correspondance de fichiers, consultez la référence modèles de correspondance de fichiers.

Exemples

Extraire tous les fichiers .zip de manière récursive

Cet exemple extrait tous les fichiers .zip de manière récursive, y compris les fichiers racines et les fichiers des sous-dossiers.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Extraire tous les fichiers .zip du sous-dossier

Cet exemple extrait test/one.zip et test/two.zip, mais laisse test/nested/three.zip.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: 'test/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Spécifications

Besoin	Descriptif
Types de pipelines	YAML, Build Classique, Version Classique
Exécutions sur	Agent, DeploymentGroup
demandes	Aucun
fonctionnalités de	Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande	Cette tâche s’exécute à l’aide des restrictions de commande suivantes: restreint
variables settables	Cette tâche est autorisée à définir les variables suivantes: la définition des variables est désactivée
Version de l’agent	2.182.1 ou version ultérieure
Catégorie de tâche	Utilité

Voir aussi

• Informations de référence sur les modèles de correspondance de fichiers