ExtractFiles@1 — wyodrębnianie plików w wersji 1 — zadanie

To zadanie służy do wyodrębniania różnych plików archiwum i kompresji, takich jak .7z, .rar, tar.gz i .zip.

Składnia

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

Dane wejściowe

archiveFilePatterns - Wzorce plików archiwum
string. Wymagane. Wartość domyślna: **/*.zip.

Określa ścieżki plików lub wzorce plików archiwum do wyodrębnienia. Obsługuje wiele linii wzorców minimatch. Dowiedz się więcej o zadaniu Wyodrębnij pliki.

Określa wzorce, które mają być zgodne z archiwami, które chcesz wyodrębnić. Domyślnie wzorce są uruchamiane w folderze głównym repozytorium (tak samo jak w przypadku określenia parametru $(Build.SourcesDirectory).
Określa filtry wzorców, po jednym na wiersz, które pasują do archiwów do wyodrębnienia. Przykład:

• test.zip Wyodrębnia plik test.zip w folderze głównym.
• test/*.zip wyodrębnia wszystkie pliki .zip w folderze testowym.
• **/*.tar Wyodrębnia wszystkie pliki tar w folderze głównym i podfolderach.
• **/bin/*.7z wyodrębnia wszystkie pliki 7z w dowolnym podfolderze o nazwie "bin".
  Wzorzec służy do dopasowywania tylko ścieżek plików archiwum, a nie ścieżek folderów, a nie do wyodrębniania zawartości archiwum. Dlatego należy określić wzorce, takie jak **/bin/** zamiast **/bin.

destinationFolder - Folder docelowy
string. Wymagane.

Określa folder docelowy, do którego mają zostać wyodrębnione pliki archiwum. Użyj zmiennych , jeśli pliki nie znajdują się w repozytorium. Na przykład: $(agent.builddirectory).

cleanDestinationFolder - Wyczyść folder docelowy przed wyodrębnieniem
boolean. Wartość domyślna: true.

Określa opcję oczyszczenia katalogu docelowego przed wyodrębnienie do niego zawartości archiwum.

overwriteExistingFiles - Zastąp istniejące pliki
boolean. Wartość domyślna: false.

Określa opcję zastąpienia istniejących plików w katalogu docelowym, jeśli już istnieją. Jeśli opcja to false, skrypt monituje o istniejące pliki, pytając, czy chcesz je zastąpić.

pathToSevenZipTool - Ścieżka do narzędzia 7z
string.

Określa niestandardową ścieżkę do narzędzia 7z. Na przykład C:\7z\7z.exe w systemach Windows i /usr/local/bin/7z MacOS/Ubuntu. Jeśli nie zostanie określony w systemie Windows, zostanie użyta domyślna wersja 7zip dostarczona z zadaniem.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

To zadanie służy do wyodrębniania plików z archiwów do folderu docelowego przy użyciu wzorców dopasowania. Obsługiwany jest szereg standardowych formatów archiwum, w tym .zip, jar, war, .ear, .tar, .7z i nie tylko.

Aby uzyskać więcej informacji na temat wzorców dopasowywania plików, zobacz Dokumentację wzorców dopasowywania plików.

Przykłady

Wyodrębnianie wszystkich plików .zip rekursywnie

W tym przykładzie zostaną wyodrębnione wszystkie pliki .zip cyklicznie, w tym pliki główne i pliki z podfolderów.

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

Wyodrębnianie wszystkich plików .zip z podfolderu

W tym przykładzie zostaną wyodrębnione test/one.zip elementy i test/two.zip, ale pozostawi test/nested/three.zipwartość .

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

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa w	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	To zadanie jest uruchamiane przy użyciu następujących ograniczeń poleceń: ograniczone
Zmienne ustawialne	To zadanie ma uprawnienia do ustawiania następujących zmiennych: Ustawienie zmiennych jest wyłączone
Wersja agenta	2.182.1 lub nowsza
Kategoria zadania	Narzędzie

Zobacz też

• Odwołanie do wzorców dopasowywania plików