ExtractFiles@1 — задача извлечения файлов версии 1

Используйте эту задачу для извлечения различных архивных файлов и файлов сжатия, таких как .7z, .rar, .tar.gz и .zip.

Синтаксис

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

Входные данные

archiveFilePatterns - Шаблоны файлов архивации
string. Обязательный. Значение по умолчанию: **/*.zip.

Указывает пути к файлам или шаблоны архивных файлов для извлечения. Поддерживает несколько линий шаблонов мини-сопоставления. Дополнительные сведения о задаче "Извлечение файлов".

Указывает шаблоны, соответствующие архивам, которые требуется извлечь. По умолчанию шаблоны запускают в корневой папке репозитория (как если бы вы указали $(Build.SourcesDirectory).
Указывает фильтры шаблонов , по одному на строку, которые соответствуют архивам для извлечения. Пример:

• test.zip извлекает файл test.zip в корневую папку.
• test/*.zip извлекает все .zip файлы в папке test.
• **/*.tar извлекает все TAR-файлы в корневой папке и вложенных папках.
• **/bin/*.7z извлекает все файлы .7Z из любой вложенной папки с именем bin.
  Шаблон используется для сопоставления только путей к архивным файлам, а не путей к папкам и архивного содержимого для извлечения. Поэтому следует указать шаблоны, например , а **/bin/** не **/bin.

destinationFolder - Конечная папка
string. Обязательный.

Указывает целевую папку, в которую следует извлечь архивные файлы. Используйте переменные , если файлы отсутствуют в репозитории. Например: $(agent.builddirectory).

cleanDestinationFolder - Очистка конечной папки перед извлечением
boolean. Значение по умолчанию: true.

Указывает параметр очистки целевого каталога перед извлечением в него содержимого архива.

overwriteExistingFiles - Перезапись существующих файлов
boolean. Значение по умолчанию: false.

Указывает параметр для перезаписи существующих файлов в целевом каталоге, если они уже существуют. Если параметр имеет значение false, скрипт запросит существующие файлы с запросом на их перезапись.

pathToSevenZipTool - Путь к служебной программе 7z
string.

Указывает пользовательский путь к служебной программе 7z. Например, C:\7z\7z.exe в Windows и /usr/local/bin/7z MacOS/Ubuntu. Если он не указан в Windows, будет использоваться версия по умолчанию 7ZIP, поставляемая с задачей.

Параметры управления задачами

Все задачи имеют параметры управления в дополнение к входным данным задачи. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Remarks

Используйте эту задачу для извлечения файлов из архивов в целевую папку с помощью шаблонов соответствия. Поддерживается ряд стандартных форматов архивов, включая .zip, JAR, WAR, EAR, TAR, .7Z и т. д.

Дополнительные сведения о шаблонах сопоставления файлов см. в справочнике по шаблонам сопоставления файлов.

Примеры

Рекурсивное извлечение всех файлов .zip

В этом примере рекурсивно извлекаются все .zip файлы, включая корневые файлы и файлы из вложенных папок.

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

Извлечение всех .zip файлов из вложенной папки

В этом примере будут извлечены test/one.zip и test/two.zip, но останется test/nested/three.zip.

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

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
Требования	Нет
Capabilities	Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд	Эта задача выполняется с использованием следующих ограничений команд: restricted
Устанавливаемые переменные	Эта задача имеет разрешение на установку следующих переменных: параметр переменных отключен
Версия агента	2.182.1 или более поздней версии
Категория задач	Служебная программа

См. также раздел

• Справочник по шаблонам сопоставления файлов