ArchiveFiles@2 - Tâche Archiver les fichiers v2

Archivez les 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 chemin d’accès aux fichiers à ajouter à l’archive. Pour les dossiers, tout ce qui se trouve dans le dossier nommé est ajouté à l’archive.

includeRootFolder - Ajouter le nom du dossier racine aux chemins d’archivage
boolean. Valeur par défaut : true.

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

Par exemple, si le dossier racine est : /home/user/output/classes/ et le chemin du fichier : com/acme/Main.class. L’archive résultante contient : classes/com/acme/Main.class. Dans le cas contraire, l’archive résultante contiendra : com/acme/Main.class.

archiveType - Type d’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 -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, utilisé 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’archive à créer : foo.jar

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

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

tarCompression - 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 de 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)

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

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

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

replaceExistingArchive - Remplacer l’archive existante
boolean. Valeur par défaut : true.

Par défaut, remplace une archive existante. Sinon, quand la valeur est définie 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 - Non compressé uniquement
• 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 définie sur true, force les outils à utiliser une sortie silencieuse. Le verbose paramètre (ou équivalent) peut remplacer ce paramètre.

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

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