Partager via


ArchiveFiles@2 - Tâche Archiver des fichiers v2

Archivez des fichiers à l’aide de formats de compression tels que .7z, .tar, .gz et .zip.

Syntaxe

# Archive files v2
# Compress files into .7z, .tar.gz, or .zip.
- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(Build.BinariesDirectory)' # string. Required. Root folder or file to archive. Default: $(Build.BinariesDirectory).
    #includeRootFolder: true # boolean. Prepend root folder name to archive paths. Default: true.
  # Archive
    archiveType: 'zip' # 'zip' | '7z' | 'tar' | 'wim'. Required. Archive type. Default: zip.
    #sevenZipCompression: 'normal' # 'ultra' | 'maximum' | 'normal' | 'fast' | 'fastest' | 'none'. Optional. Use when archiveType = 7z. 7z compression. Default: normal.
    #tarCompression: 'gz' # 'gz' | 'bz2' | 'xz' | 'none'. Optional. Use when archiveType = tar. Tar compression. Default: gz.
    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip' # string. Required. Archive file to create. Default: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.
    #replaceExistingArchive: true # boolean. Replace existing archive. Default: true.
    #verbose: false # boolean. Force verbose output. Default: false.
    #quiet: false # boolean. Force quiet output. Default: false.

Entrées

rootFolderOrFile - dossier racine ou fichier à archiver
string. Obligatoire. Valeur par défaut : $(Build.BinariesDirectory).

Nom du dossier racine ou du chemin d’accès du fichier aux fichiers à ajouter à l’archive. Pour les dossiers, tout ce qui se trouve dans le dossier nommé est ajouté à l’archive.


includeRootFolder - nom du dossier racine prepend pour archiver les chemins d’accès
boolean. Valeur par défaut : true.

Place le nom du dossier racine dans les chemins d’accès aux fichiers dans l’archive. Sinon, tous les chemins d’accès aux fichiers démarrent un niveau inférieur.

Par exemple, si le dossier racine est : /home/user/output/classes/ et le chemin d’accès au fichier : com/acme/Main.class. L’archive résultante contient : classes/com/acme/Main.class. Sinon, l’archive résultante contient : com/acme/Main.class.


archiveType - type Archive
string. Obligatoire. Valeurs autorisées : zip, 7z, tar, wim. Valeur par défaut : zip.

Spécifie un format de compression. Les formats valides sont les suivants :

  • zip - Valeur par défaut. Choisissez ce format pour tous les types compatibles zip tels que .zip, .jar, .war, .ear
  • 7z - format 7-Zip, (.7z)
  • tar - format tar, utilisation pour les tars compressés, notamment .tar.gz, .tar.bz2, .tar.xz
  • wim - format wim, .wim

Exemple : pour créer une archive nommée foo.jar:

  • Sélectionner le format de compression zip
  • Spécifiez le nom du fichier d’archivage à créer : foo.jar

sevenZipCompression - Compression 7z
string. Optionnel. Utilisez quand archiveType = 7z. Valeurs autorisées : ultra, maximum, normal, fast, fastest, none. Valeur par défaut : normal.

Définissez le niveau de compression ou None pour créer un fichier .7z non compressé.


tarCompression - de compression Tar
string. Optionnel. Utilisez quand archiveType = tar. Valeurs autorisées : gz, bz2, xz, none. Valeur par défaut : gz.

Définissez un format de compression ou choisissez None pour créer un fichier .tar non compressé.

  • gz - Format par défaut pour la compression gzip (.tar.gz, .tar.tgz, .taz)
  • bz2 - compression bzip2 (.tar.bz2, .tz2, .tbz2)
  • xz - compression xz (.tar.xz, .txz)

fichier archive archiveFile - pour créer
string. Obligatoire. Valeur par défaut : $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

Spécifiez le nom du fichier d’archivage à créer. Par exemple, pour créer foo.tgz:

  • Définir le type d’archive : tar
  • Définir la compression tar : gz

replaceExistingArchive - Remplacer les d’archivage existants
boolean. Valeur par défaut : true.

Par défaut, remplace une archive existante. Sinon, lorsqu’il est défini sur false, les fichiers tar non compressés sont ajoutés à l’archive existante.

Formats de fichiers pris en charge pouvant être ajoutés à une archive existante :

  • zip
  • 7z
  • tar - Uniquement décompressé
  • wim

verbose - Forcer la sortie détaillée
boolean. Valeur par défaut : false.

Si la valeur est true, force les outils à utiliser une sortie détaillée. Remplace le paramètre « silencieux ».


quiet - Forcer la sortie silencieuse
boolean. Valeur par défaut : false.

Si la valeur est true, force les outils à utiliser une sortie silencieuse. Le paramètre verbose (ou équivalent) peut remplacer ce paramètre.


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 créer un fichier d’archivage à partir d’un dossier source. Les formats d’archive standard sont pris en charge, notamment .zip, .jar, .war, .ear, .tar, .7z, etc.

Spécifications

Besoin Descriptif
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, Groupe de déploiement
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é