ExtractFiles@1 - Tâche Extraire des fichiers v1

Utilisez cette tâche pour extraire divers 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 fichiers d’archivage
string. Obligatoire. Valeur par défaut : **/*.zip.

Spécifie les chemins d’accès aux fichiers ou les modèles des 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 correspondant aux 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 un sous-dossier nommé « bin ».
  Le modèle est utilisé pour correspondre uniquement aux chemins d’accès aux fichiers d’archive, et non aux chemins d’accès aux dossiers, et non au contenu d’archive à extraire. Par conséquent, vous devez spécifier des modèles, par **/bin/** exemple au lieu de **/bin.

destinationFolder - Dossier de destination
string. Obligatoire.

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

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

Spécifie l’option permettant de nettoyer le répertoire de destination avant que le contenu de l’archive y soit extrait.

overwriteExistingFiles - Remplacer des 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 vous invite sur les fichiers existants, vous demandant si vous souhaitez 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. Si elle n’est pas spécifiée sur Windows, la version 7zip par défaut fournie avec une tâche est utilisée.

Options de contrôle des tâches

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

Variables de sortie

Aucun.

Notes

Utilisez cette tâche pour extraire des fichiers des archives vers un dossier cible à l’aide de modèles de correspondance. Une gamme de formats d’archivage 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

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	Aucun
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes	Cette tâche s’exécute à l’aide des restrictions de commande suivantes : restricted
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 la tâche	Utilitaire

Voir aussi

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