ArchiveFiles@2 – Archivace souborů v2 – úloha

Archivovat soubory pomocí formátů komprese, jako jsou .7z, .tar, .gz a .zip.

Syntaxe

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

Vstupy

rootFolderOrFile - kořenové složky nebo souboru pro archivaci
string. Povinné. Výchozí hodnota: $(Build.BinariesDirectory).

Název kořenové složky nebo cesty 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řipravený název kořenové složky pro archivaci cest
boolean. Výchozí hodnota: true.

Předzálohuje název kořenové složky na cesty k souborům v archivu. Jinak budou všechny cesty k souborům začínat o jednu úroveň nižší.

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é. Povolené hodnoty: zip, 7z, tarwim. Výchozí hodnota: zip.

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

• zip – výchozí. Zvolte tento formát pro všechny typy kompatibilní se zipem, jako jsou .zip, .jar, .war, .ear
• 7z – formát 7 zip (.7z)
• tar – formát taru, 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. Volitelný. Používá se při archiveType = 7z. Povolené hodnoty: ultra, maximum, normal, fast, fastest, none. Výchozí hodnota: normal.

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

tarCompression - komprese Tar
string. Volitelný. Používá se při archiveType = tar. Povolené hodnoty: gz, bz2, xznone. Výchozí hodnota: gz.

Nastavte formát komprese nebo zvolte None a vytvořte nekomprimovaný .tar soubor.

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

archiveFile - Archivní soubor pro vytvoření
string. Povinné. Výchozí hodnota: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

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

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

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

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

Podporované formáty souborů, které lze přidat do existujícího archivu:

• zip
• 7z
• tar – pouze nekomprimované
• 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í nástroje, aby používaly tichý výstup. Nastavení verbose (nebo ekvivalentní) může toto nastavení přepsat.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Žádné.

Poznámky

Pomocí této úlohy můžete vytvořit archivní soubor ze zdrojové složky. Standardní formáty archivu jsou podporovány včetně .zip, .jar, .war, .ear, .tar, .7z a dalších.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení, 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 spouští s následujícími omezeními příkazů : omezeno:
nastavitelné proměnné	Tento úkol má oprávnění nastavit následující proměnné: Nastavení proměnných je zakázáno.
Verze agenta	2.182.1 nebo vyšší
Kategorie úkolu	Užitnost