Dela via


ArchiveFiles@2 – Arkivera filer v2-uppgift

Arkivera filer med komprimeringsformat som .7z, .tar, .gz och .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.

Ingångar

rootFolderOrFile - rotmapp eller fil som ska arkiveras
string. Obligatoriskt. Standardvärde: $(Build.BinariesDirectory).

Namnet på rotmappen eller filsökvägen till filer som ska läggas till i arkivet. För mappar läggs allt i den namngivna mappen till i arkivet.


includeRootFolder - Rotmappsnamn för prepend till arkivsökvägar
boolean. Standardvärde: true.

Förbereder rotmappsnamnet till filsökvägarna i arkivet. Annars startar alla filsökvägar en nivå lägre.

Om rotmappen till exempel är: /home/user/output/classes/ och filsökvägen: com/acme/Main.class. Det resulterande arkivet innehåller: classes/com/acme/Main.class. Annars innehåller det resulterande arkivet: com/acme/Main.class.


archiveType - Arkivtyp
string. Obligatoriskt. Tillåtna värden: zip, 7z, tar, wim. Standardvärde: zip.

Anger ett komprimeringsformat. Giltiga format är:

  • zip – standard. Välj det här formatet för alla zip-kompatibla typer som .zip, .jar, .war, .ear
  • 7z - 7-Zip-format, (.7z)
  • tar – tjärformat, användning för komprimerade tjäror, inklusive .tar.gz, .tar.bz2, .tar.xz
  • wim – wim-format, .wim

Exempel: skapa ett arkiv med namnet foo.jar:

  • Välj komprimeringsformat zip
  • Ange namnet på arkivfilen som ska skapas: foo.jar

sevenZipCompression - 7z komprimering
string. Valfritt. Använd när archiveType = 7z. Tillåtna värden: ultra, maximum, normal, fast, fastest, none. Standardvärde: normal.

Ange komprimeringsnivå eller None för att skapa en okomprimerad .7z fil.


sevenZipCompression - 7z komprimering
string. Valfritt. Använd när archiveType = 7z. Tillåtna värden: ultra, maximum, normal, fast, fastest, none. Standardvärde: 5.

Ange ett komprimeringsformat eller None för att skapa en okomprimerad .7z fil.


tarCompression - Tar-komprimering
string. Valfritt. Använd när archiveType = tar. Tillåtna värden: gz, bz2, xz, none. Standardvärde: gz.

Ange ett komprimeringsformat eller välj None för att skapa en okomprimerad .tar fil.

  • gz – Standardformat för gzip-komprimering (.tar.gz, .tar.tgz, .taz)
  • bz2 – bzip2-komprimering (.tar.bz2, .tz2, .tbz2)
  • xz – xz-komprimering (.tar.xz, .txz)

archiveFile - arkivfil för att skapa
string. Obligatoriskt. Standardvärde: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

Ange namnet på arkivfilen som ska skapas. Om du till exempel vill skapa foo.tgz:

  • Ange arkivtyp: tar
  • Ange tjärkomprimering: gz

replaceExistingArchive - Ersätt befintligt arkiv
boolean. Standardvärde: true.

Som standard skriver du över ett befintligt arkiv. Annars läggs okomprimerade tar-filer till i det befintliga arkivet när det är inställt på false.

Filformat som stöds och som kan läggas till i ett befintligt arkiv:

  • zip
  • 7z
  • tar – Endast okomprimerad
  • wim

verbose - Framtvinga utförliga utdata
boolean. Standardvärde: false.

Om värdet är true tvingar det verktyg att använda utförliga utdata. Åsidosätter inställningen "tyst".


quiet - Framtvinga tyst utdata
boolean. Standardvärde: false.

Om värdet är inställt på truetvingar verktygen att använda tysta utdata. Inställningen verbose (eller motsvarande) kan åsidosätta den här inställningen.


Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Använd den här uppgiften för att skapa en arkivfil från en källmapp. Standardarkivformat stöds, inklusive .zip, .jar, .war, .ear, .tar, .7z med mera.

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
kräver Ingen
funktioner Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar Den här aktiviteten körs med hjälp av följande kommandobegränsningar: begränsad
variabler som kan Den här uppgiften har behörighet att ange följande variabler: Inställningsvariabler är inaktiverade
Agentversion 2.182.1 eller senare
Aktivitetskategori Nytta
Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
kräver Ingen
funktioner Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar Vilken som helst
variabler som kan Vilken som helst
Agentversion Alla agentversioner som stöds.
Aktivitetskategori Nytta