Sdílet prostřednictvím


ArchiveFiles@2 – úloha Archivace souborů v2

Archivujte soubory pomocí kompresních formátů, jako jsou .7z, .tar, .gz a .zip.

Archivujte soubory pomocí kompresních formátů, jako jsou .7z, .rar, .tar., .gz a .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.

Vstupy

rootFolderOrFile - Kořenová složka nebo soubor k archivaci
string. Povinná hodnota. Výchozí hodnota: $(Build.BinariesDirectory).

Název kořenové složky nebo cesta k souborům, které chcete přidat do archivu. U složek se všechno v pojmenované složce přidá do archivu.


includeRootFolder - Předpřidět název kořenové složky k archivačním cestám
boolean. Výchozí hodnota: true.

Předpřidá název kořenové složky do cest k souborům v archivu. Jinak budou všechny cesty k souborům začínat o jednu úroveň níže.

Pokud je například kořenová složka: /home/user/output/classes/ a cesta k souboru: com/acme/Main.class. Výsledný archiv bude obsahovat: classes/com/acme/Main.class. V opačném případě bude výsledný archiv obsahovat: com/acme/Main.class.


archiveType - Typ archivu
string. Povinná hodnota. Povolené hodnoty: zip, 7z, tar, . wim Výchozí hodnota: zip.

Určuje formát komprese. Mezi platné formáty patří:

  • zip -Výchozí. Tento formát zvolte pro všechny typy kompatibilní se zipem, jako jsou .zip, .jar, .war, .ear
  • 7z - Formát 7 Zip, (.7z)
  • tar - tar formát, slouží pro komprimované dehty, včetně .tar.gz, .tar.bz2, .tar.xz
  • wim – formát wim, .wim

Příklad vytvoření archivu s názvem foo.jar:

  • Výběr formátu komprese zip
  • Zadejte název souboru archivu, který chcete vytvořit: foo.jar

sevenZipCompression - Komprese 7z
string. Nepovinný parametr. Použijte, když archiveType = 7z. Povolené hodnoty: ultra, maximum, , fastnormal, , fastest, . none Výchozí hodnota: normal.

Nastavte úroveň komprese nebo None vytvořte nekomprimovaný soubor .7z.


sevenZipCompression - Komprese 7z
string. Nepovinný parametr. Použijte, když archiveType = 7z. Povolené hodnoty: ultra, maximum, , fastnormal, , fastest, . none Výchozí hodnota: 5.

Nastavte formát komprese nebo None vytvořte nekomprimovaný soubor .7z.


tarCompression - Komprese dehtu
string. Nepovinný parametr. Použijte, když archiveType = tar. Povolené hodnoty: gz, bz2, xz, . none Výchozí hodnota: gz.

Nastavte formát komprese nebo zvolte None vytvoření nekomprimovaného souboru .tar.

  • gz – Výchozí formát pro kompresi gzip (.tar.gz, .tar.tgz, .taz)
  • bz2 - bzip2 compression (.tar.bz2, .tz2, .tbz2)
  • xz - komprese xz (.tar.xz, .txz)

archiveFile - Archivovat soubor k vytvoření
string. Povinná hodnota. Výchozí hodnota: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

Zadejte název souboru archivu, který chcete vytvořit. Pokud chcete například vytvořit foo.tgz:

  • Nastavit typ archivu: tar
  • Nastavení komprese tar: gz

replaceExistingArchive - Nahradit existující archiv
boolean. Výchozí hodnota: true.

Ve výchozím nastavení přepíše existující archiv. V opačném případě se nekomprimované falsesoubory tar přidají do existujícího archivu.

Podporované formáty souborů, které je možné přidat do existujícího archivu:

  • zip
  • 7z
  • tar - Pouze nekomprimováno
  • wim

verbose - Vynucení podrobného výstupu
boolean. Výchozí hodnota: false.

Pokud je nastavená hodnota true, vynutí nástroje, aby používaly podrobný výstup. Přepíše nastavení "quiet".


quiet - Vynutit tichý výstup
boolean. Výchozí hodnota: false.

Pokud je nastavená hodnota true, vynutí, aby nástroje používaly tichý výstup. Nastavení verbose (nebo ekvivalentní) může toto nastavení přepsat.


Možnosti řízení úkolů

Všechny úkoly mají kromě vstupů úkolů i možnosti řízení. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Tato úloha slouží k vytvoření souboru archivu ze zdrojové složky. Podporují se standardní formáty archivu, včetně .zip, .jar, .war, .ear, .tar, .7z a dalších.

Požadavky

Požadavek Popis
Typy kanálů YAML, klasický build, klasická verze
Běží na Agent, DeploymentGroup
Požadavky Žádné
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Tato úloha se spustí pomocí následujících omezení příkazu: restricted
Nastavitelné proměnné Tato úloha má oprávnění k nastavení následujících proměnných: Nastavení proměnných je zakázáno.
Verze agenta 2.182.1 nebo vyšší
Kategorie úloh Nástroj
Požadavek Popis
Typy kanálů YAML, classic build, verze Classic
Spustí se Agent, DeploymentGroup
Požadavky Žádné
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta Všechny podporované verze agenta.
Kategorie úloh Nástroj