ExtractFiles@1 – úloha Extrakce souborů v1

Tento úkol slouží k extrahování různých archivních a komprimačních souborů, jako jsou .7z, .rar, .tar.gz a .zip.

Syntax

# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip' # string. Required. Archive file patterns. Default: **/*.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
    #overwriteExistingFiles: false # boolean. Overwrite existing files. Default: false.
    #pathToSevenZipTool: # string. Path to 7z utility.

Vstupy

archiveFilePatterns - Vzory archivačních souborů
string. Povinná hodnota. Výchozí hodnota: **/*.zip.

Určuje cesty k souborům nebo vzory archivních souborů, které se mají extrahovat. Podporuje více řádků minimatch vzorů. Přečtěte si další informace o úloze Extrahovat soubory.

Určuje vzory, které se mají shodovat s archivy, které chcete extrahovat. Ve výchozím nastavení vzory začínají v kořenové složce úložiště (stejně, jako kdybyste zadali $(Build.SourcesDirectory).
Určuje filtry vzorů (jeden na řádek), které odpovídají archivům, které se mají extrahovat. Příklad:

• test.zip extrahuje test.zip soubor v kořenové složce.
• test/*.zip extrahuje všechny .zip soubory v testovací složce.
• **/*.tar extrahuje všechny soubory .tar v kořenové složce a podsložkách.
• **/bin/*.7z extrahuje všechny soubory .7z v libovolné podsložce s názvem "bin".
  Vzor se používá k porovnávání pouze cest archivních souborů, nikoli cest ke složkám, a nikoli k archivaci obsahu, který má být extrahován. Proto byste měli zadat vzory, například **/bin/** místo **/bin.

destinationFolder - Cílová složka
string. Povinná hodnota.

Určuje cílovou složku, do které se mají extrahovat archivní soubory. Pokud soubory nejsou v úložišti, použijte proměnné . Příklad: $(agent.builddirectory).

cleanDestinationFolder - Před extrahováním vyčistěte cílovou složku.
boolean. Výchozí hodnota: true.

Určuje možnost vyčištění cílového adresáře před extrahováním obsahu archivu do něj.

overwriteExistingFiles - Přepsání existujících souborů
boolean. Výchozí hodnota: false.

Určuje možnost přepsání existujících souborů v cílovém adresáři, pokud již existují. Pokud je falsemožnost , skript zobrazí výzvu u existujících souborů s dotazem, jestli je chcete přepsat.

pathToSevenZipTool - Cesta k nástroji 7z
string.

Určuje vlastní cestu k nástroji 7z. Například C:\7z\7z.exe ve Windows a /usr/local/bin/7z v systému MacOS/Ubuntu. Pokud není v systému Windows zadaný, použije se výchozí verze 7zip dodaná spolu s úlohou.

Možnosti řízení úkolů

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

Výstupní proměnné

Žádné

Poznámky

Pomocí této úlohy můžete extrahovat soubory z archivů do cílové složky pomocí vzorů shody. Podporuje se řada standardních archivních formátů, včetně .zip, .jar, .war, .ear, .tar, .7z a dalších.

Další informace o vzorech porovnávání souborů najdete v referenčních informacích o vzorech porovnávání souborů.

Příklady

Rekurzivní extrakce všech souborů .zip

Tento příklad extrahuje všechny .zip soubory rekurzivně, včetně kořenových souborů i souborů z podsložek.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Extrahování všech souborů .zip z podsložky

Tento příklad extrahuje test/one.zip a test/two.zip, ale ponechá test/nested/three.zip.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: 'test/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Požadavky

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ů	Tato úloha se spustí pomocí následujících omezení příkazů: 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

Viz také

• Referenční informace ke vzorům porovnávání souborů