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.
# 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.
# 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.
# 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.
Входные данные
archiveFilePatterns
- Шаблоны файлов архивации
string
. Обязательный. Значение по умолчанию: **/*.zip
.
Указывает пути к файлам или шаблоны архивных файлов для извлечения. Поддерживает несколько линий шаблонов мини-сопоставления. Дополнительные сведения о задаче "Извлечение файлов".
Указывает шаблоны, соответствующие архивам, которые требуется извлечь. По умолчанию шаблоны запускают в корневой папке репозитория (как если бы вы указали $(Build.SourcesDirectory)
.
Указывает фильтры шаблонов , по одному на строку, которые соответствуют архивам для извлечения. Пример:
test.zip
извлекает файл test.zip в корневую папку.test/*.zip
извлекает все .zip файлы в папке test.**/*.tar
извлекает все TAR-файлы в корневой папке и вложенных папках.**/bin/*.7z
извлекает все файлы .7Z из любой вложенной папки с именем bin.
Шаблон используется для сопоставления только путей к архивным файлам, а не путей к папкам и архивного содержимого для извлечения. Поэтому следует указать шаблоны, например , а**/bin/**
не**/bin
.
archiveFilePatterns
- Шаблоны файлов архивации
string
. Обязательный. Значение по умолчанию: *.zip
.
Указывает пути к файлам или шаблоны архивных файлов для извлечения. Поддерживает несколько линий шаблонов мини-сопоставления. Дополнительные сведения о задаче "Извлечение файлов".
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 или более поздней версии |
Категория задач | Служебная программа |
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка, классический выпуск |
Выполняется в | Агент, DeploymentGroup |
Требования | Нет |
Capabilities | Эта задача не удовлетворяет требованиям для последующих задач в задании. |
Ограничения команд | Любой |
Устанавливаемые переменные | Любой |
Версия агента | Все поддерживаемые версии агента. |
Категория задач | Служебная программа |