ArchiveFiles@2 : Dateiarchivieren v2-Aufgabe

Archivieren Sie Dateien mithilfe von 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.

Eingaben

rootFolderOrFile - Stammordner oder zu archivierende Datei
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, um Pfade zu archivieren
boolean. Standardwert. true.

Stellt den Namen des Stammordners dateipfaden im Archiv vor. Andernfalls beginnen alle Dateipfade eine Ebene tiefer.

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

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

Gibt ein Komprimierungsformat an. Gültige Formate sind:

• zip -Standard. Wählen Sie dieses Format für alle ZIP-kompatiblen Typen aus, z. B. .zip, JAR, WAR, EAR
• 7z - 7-Zip-Format, (.7z)
• tar - tar-Format, verwenden Sie für komprimierte Tars, einschließlich .tar.gz, .tar.bz2, .tar.xz
• wim – wim format, .wim

Beispiel, um ein Archiv mit dem Namen foo.jarzu erstellen:

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

sevenZipCompression - 7z-Komprimierung
string. Optional. Verwenden Sie , wenn archiveType = 7z. Zulässige Werte: ultra, maximum, normal, fast, fastest, . none Standardwert. normal.

Legen Sie den Komprimierungsgrad fest, oder None erstellen Sie eine unkomprimierte .7z-Datei.

tarCompression - Tar-Komprimierung
string. Optional. Verwenden Sie , wenn archiveType = tar. Zulässige Werte: gz, bz2, xz, none. Standardwert. gz.

Legen Sie ein Komprimierungsformat fest, oder erstellen Sie None eine nicht komprimierte TAR-Datei.

• 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 - Zu erstellende Archivdatei
string. Erforderlich. Standardwert. $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

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

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

replaceExistingArchive - Ersetzen eines vorhandenen Archivs
boolean. Standardwert. true.

Standardmäßig überschreibt ein vorhandenes Archiv. Andernfalls werden unkomprimierte TAR-Dateien beim Festlegen falseauf das vorhandene Archiv hinzugefügt.

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

• zip
• 7z
• tar - Nur unkomprimiert
• wim

verbose - Ausführliche Ausgabe erzwingen
boolean. Standardwert. false.

Wenn sie auf true festgelegt ist, müssen Tools die ausführliche Ausgabe verwenden. Überschreibt die Einstellung "leise".

quiet - Erzwingen der leisen Ausgabe
boolean. Standardwert. false.

Wenn auf truefestgelegt ist, werden Tools gezwungen, die leise Ausgabe zu verwenden. Die verbose Einstellung (oder eine entsprechende) kann diese Einstellung überschreiben.

Aufgabensteuerungsoptionen

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

Ausgabevariablen

Keine.

Hinweise

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

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Dieser Task wird mit den folgenden Befehlseinschränkungen ausgeführt: restricted
Einstellbare Variablen	Diese Aufgabe verfügt über die Berechtigung zum Festlegen der folgenden Variablen: Festlegen von Variablen ist deaktiviert.
Agent-Version	2.182.1 oder höher
Aufgabenkategorie	Hilfsprogramm