ArchiveFiles@2 : Dateiarchivieren v2-Aufgabe
Archivieren Sie Dateien mithilfe von Komprimierungsformaten wie .7z, .tar, .gz und .zip.
Archivieren Sie Dateien mit Komprimierungsformaten wie .7z, .rar, .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.
# 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: '5' # 'ultra' | 'maximum' | 'normal' | 'fast' | 'fastest' | 'none'. Optional. Use when archiveType = 7z. 7z compression. Default: 5.
#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.
# 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.
#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.
# Archive Files v2
# Archive files using compression formats such as .7z, .rar, .tar.gz, and .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.
#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.
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, EAR7z
- 7-Zip-Format, (.7z)tar
- tar-Format, verwenden Sie für komprimierte Tars, einschließlich .tar.gz, .tar.bz2, .tar.xzwim
– wim format, .wim
Beispiel, um ein Archiv mit dem Namen foo.jar
zu 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.
sevenZipCompression
- 7z-Komprimierung
string
. Optional. Verwenden Sie , wenn archiveType = 7z
. Zulässige Werte: ultra
, maximum
, normal
, fast
, fastest
, . none
Standardwert. 5
.
Legen Sie ein Komprimierungsformat 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 false
auf das vorhandene Archiv hinzugefügt.
Unterstützte Dateiformate, die einem vorhandenen Archiv hinzugefügt werden können:
zip
7z
tar
- Nur unkomprimiertwim
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 true
festgelegt 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 |
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 | Any |
Einstellbare Variablen | Any |
Agent-Version | Alle unterstützten Agent-Versionen. |
Aufgabenkategorie | Hilfsprogramm |