Delen via


ArchiveFiles@2 - Archiefbestanden v2-taak

Bestanden archiveren met compressieindelingen zoals .7z, .tar, .gz en .zip.

Syntaxis

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

Invoer

rootFolderOrFile - hoofdmap of bestand voor het archiveren van
string. Verplicht. Standaardwaarde: $(Build.BinariesDirectory).

Naam van de hoofdmap of het bestandspad naar bestanden die u aan het archief wilt toevoegen. Voor mappen wordt alles in de benoemde map toegevoegd aan het archief.


includeRootFolder - naam van de hoofdmap vooraf opgeven om paden te archiveren
boolean. Standaardwaarde: true.

Hiermee wordt de naam van de hoofdmap voorafgegaan door bestandspaden in het archief. Anders beginnen alle bestandspaden één niveau lager.

Als de hoofdmap bijvoorbeeld is: /home/user/output/classes/ en het bestandspad: com/acme/Main.class. Het resulterende archief bevat: classes/com/acme/Main.class. Anders bevat het resulterende archief: com/acme/Main.class.


archiveType - archieftype
string. Verplicht. Toegestane waarden: zip, 7z, tar, . wim Standaardwaarde: zip.

Hiermee geeft u een compressie-indeling. Geldige indelingen zijn:

  • zip - Standaard. Kies deze indeling voor alle zip-compatibele typen, zoals .zip, .jar, .war, .ear
  • 7z - 7 zip-indeling (.7z)
  • tar - tar-indeling, gebruikt voor gecomprimeerde tars, waaronder .tar.gz, .tar.bz2, .tar.xz
  • wim - wim-indeling, .wim

Als u bijvoorbeeld een archief wilt maken met de naam foo.jar:

  • Compressie-indeling selecteren zip
  • Geef de naam op van het archiefbestand dat u wilt maken: foo.jar

sevenZipCompression - 7z-compressie
string. Facultatief. Gebruiken wanneer archiveType = 7z. Toegestane waarden: ultra, maximum, normal, fast, fastest, none. Standaardwaarde: normal.

Stel het compressieniveau of None in om een niet-gecomprimeerd .7z bestand te maken.


sevenZipCompression - 7z-compressie
string. Facultatief. Gebruiken wanneer archiveType = 7z. Toegestane waarden: ultra, maximum, normal, fast, fastest, none. Standaardwaarde: 5.

Stel een compressie-indeling of None in om een niet-gecomprimeerd .7z bestand te maken.


tarCompression - Tar-compressie
string. Facultatief. Gebruiken wanneer archiveType = tar. Toegestane waarden: gz, bz2, xz, . none Standaardwaarde: gz.

Stel een compressie-indeling in of kies None om een niet-gecomprimeerd .tar bestand te maken.

  • gz - Standaardindeling voor gzip-compressie (.tar.gz, .tar.tgz, .taz)
  • bz2 - bzip2-compressie (.tar.bz2, .tz2, .tbz2)
  • xz - xz-compressie (.tar.xz, .txz)

archiveFile - archiefbestand voor het maken van
string. Verplicht. Standaardwaarde: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

Geef de naam op van het archiefbestand dat u wilt maken. Als u bijvoorbeeld foo.tgzwilt maken:

  • Archieftype instellen: tar
  • Tar-compressie instellen: gz

replaceExistingArchive - Bestaande archief vervangen
boolean. Standaardwaarde: true.

Overschrijft standaard een bestaand archief. Als dit niet is ingesteld op false, worden niet-gecomprimeerde tar-bestanden toegevoegd aan het bestaande archief.

Ondersteunde bestandsindelingen die kunnen worden toegevoegd aan een bestaand archief:

  • zip
  • 7z
  • tar - Alleen niet gecomprimeerd
  • wim

uitgebreide uitvoer van verbose - forceren
boolean. Standaardwaarde: false.

Als deze optie is ingesteld op waar, dwingt u de hulpprogramma's om uitgebreide uitvoer te gebruiken. Hiermee wordt de instelling 'stil' overschreven.


quiet - Stille uitvoer afdwingen
boolean. Standaardwaarde: false.

Als deze optie is ingesteld op true, worden hulpprogramma's gedwongen om stille uitvoer te gebruiken. De verbose instelling (of gelijkwaardig) kan deze instelling overschrijven.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om een archiefbestand te maken op basis van een bronmap. Standaardarchiefindelingen worden ondersteund, waaronder .zip, .jar, .war, .ear, .tar, .7z en meer.

Vereisten

Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Geen
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Deze taak wordt uitgevoerd met behulp van de volgende opdrachtbeperkingen: beperkt
variabelen instellen Deze taak is gemachtigd om de volgende variabelen in te stellen : Variabelen instellen is uitgeschakeld
Agentversie 2.182.1 of hoger
Taakcategorie Nutsvoorzieningen
Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Geen
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Welk dan ook
variabelen instellen Welk dan ook
Agentversie Alle ondersteunde agentversies.
Taakcategorie Nutsvoorzieningen