ArchiveFiles@2 – Aufgabe "Dateien archiven v2"

Archivieren Von Dateien mit Komprimierungsformaten wie .7z, .tar, .gz und .zip.

Syntax

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

Eingänge

rootFolderOrFile - Stammordner oder -datei zum Archivieren
string. Erforderlich. Standardwert: $(Build.BinariesDirectory).

Der Name des Stammordners oder der Dateipfad zu Dateien, die dem Archiv hinzugefügt werden sollen. Bei Ordnern wird alles im benannten Ordner dem Archiv hinzugefügt.

includeRootFolder - Voreingestellter Stammordnername zu Archivpfaden
boolean. Standardwert: true.

Stellt den Namen des Stammordners den Dateipfaden im Archiv voran. Andernfalls beginnen alle Dateipfade eine Ebene niedriger.

Wenn der Stammordner beispielsweise folgendes ist: /home/user/output/classes/ und der Dateipfad: com/acme/Main.class. Das resultierende Archiv enthält: classes/com/acme/Main.class. Andernfalls enthält das resultierende Archiv: com/acme/Main.class.

archiveType - Archivtyp
string. Erforderlich. Zulässige Werte: zip, 7z, tar, wim. Standardwert: zip.

Gibt ein Komprimierungsformat an. Zu den gültigen Formaten gehören:

• zip – Standard. Wählen Sie dieses Format für alle zipkompatiblen Typen wie .zip, .jar, .war, .ear
• 7z - 7-Zip-Format, (.7z)
• tar - Tar-Format, für komprimierte Tars einschließlich .tar.gz, .tar.bz2, .tar.xz
• wim - WIM-Format, WIM

So erstellen Sie beispielsweise ein Archiv mit dem Namen foo.jar:

• Komprimierungsformat auswählen zip
• Geben Sie den Namen der zu erstellenden Archivdatei an: foo.jar

sevenZipCompression - 7z-Komprimierungs-
string. Wahlfrei. Wird verwendet, wenn archiveType = 7z. Zulässige Werte: ultra, maximum, normal, fast, fastest, none. Standardwert: normal.

Legen Sie die Komprimierungsebene oder None fest, um eine nicht komprimierte .7z Datei zu erstellen.

tarCompression - Tar-Komprimierung
string. Wahlfrei. Wird verwendet, wenn archiveType = tar. Zulässige Werte: gz, bz2, xz, none. Standardwert: gz.

Legen Sie ein Komprimierungsformat fest, oder wählen Sie None aus, um eine nicht komprimierte .tar Datei zu erstellen.

• gz - Standardformat für die Gzip-Komprimierung (.tar.gz, .tar.tgz, .taz)
• bz2 - bzip2-Komprimierung (.tar.bz2, .tz2, .tbz2)
• xz - xz-Komprimierung (.tar.xz, .txz)

archiveFile - Archivdatei zum Erstellen von
string. Erforderlich. Standardwert: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

Geben Sie den Namen der zu erstellenden Archivdatei an. So erstellen Sie z. B. foo.tgz:

• Archivtyp festlegen: tar
• Festlegen der Tar-Komprimierung: gz

replaceExistingArchive - Vorhandene Archiv- ersetzen
boolean. Standardwert: true.

Überschreibt standardmäßig ein vorhandenes Archiv. Andernfalls werden unkomprimierte Tar-Dateien beim Festlegen auf falsedem vorhandenen Archiv hinzugefügt.

Unterstützte Dateiformate, die einem vorhandenen Archiv hinzugefügt werden können:

• zip
• 7z
• tar - Nur nicht komprimiert
• wim

verbose - ausführliche Ausgabe erzwingen
boolean. Standardwert: false.

Wenn dieser Wert auf "true" festgelegt ist, erzwingt die Verwendung ausführlicher Ausgabetools. Setzt die Einstellung "ruhig" außer Kraft.

quiet - ruhen erzwingen
boolean. Standardwert: false.

Wenn diese Einstellung auf truefestgelegt ist, erzwingt die Tools die Verwendung der leisen Ausgabe. Die verbose Einstellung (oder gleichwertig) kann diese Einstellung überschreiben.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Verwenden Sie diese Aufgabe, um eine Archivdatei aus einem Quellordner zu erstellen. Standardarchivformate werden unterstützt, einschließlich .zip, .jar, .war, .ear, .tar, .7z und vieles mehr.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Diese Aufgabe wird mit den folgenden Befehlseinschränkungenausgeführt: restricted
Settable-Variablen	Diese Aufgabe verfügt über die Berechtigung zum Festlegen der folgenden Variablen: Das Festlegen von Variablen ist deaktiviert.
Agentversion	2.182.1 oder höher
Vorgangskategorie	Nützlichkeit