ArchiveFiles@2 — задача архивации файлов версии 2

Архивируйте файлы с помощью форматов сжатия, таких как .7z, .tar, .gz и .zip.

Синтаксис

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

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

rootFolderOrFile - корневую папку или файл для архивации
string. Обязательное. Значение по умолчанию: $(Build.BinariesDirectory).

Имя корневой папки или пути к файлам для добавления в архив. Для папок все в именованной папке добавляется в архив.

includeRootFolder - имя корневой папки prepend для архивных путей
boolean. Значение по умолчанию: true.

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

Например, если корневая папка: /home/user/output/classes/ и путь к файлу: com/acme/Main.class. Результирующий архив будет содержать: classes/com/acme/Main.class. В противном случае результирующий архив будет содержать: com/acme/Main.class.

archiveType - Тип архива
string. Обязательное. Допустимые значения: zip, , 7ztarwim. Значение по умолчанию: zip.

Задает формат сжатия. Допустимые форматы включают:

• zip — по умолчанию. Выберите этот формат для всех совместимых zip-типов, таких как .zip, .jar, .war, .ear
• 7z — 7-ZIP-формат(.7z)
• tar — формат tar, используемый для сжатых таров, включая .tar.gz, .tar.bz2, .tar.xz
• wim — формат wim, wim

Пример создания архива с именем foo.jar:

• Выбор формата сжатия zip
• Укажите имя создаваемого архивного файла: foo.jar

sevenZipCompression - сжатия 7z
string. Необязательно. Используется при archiveType = 7z. Допустимые значения: ultra, maximum, normal, fast, fastest, none. Значение по умолчанию: normal.

Задайте уровень сжатия или None для создания несжатого файла .7z.

tarCompression - сжатие tar
string. Необязательно. Используется при archiveType = tar. Допустимые значения: gz, , bz2xznone. Значение по умолчанию: gz.

Задайте формат сжатия или выберите None для создания несжатого файла .tar.

• gz — формат по умолчанию для сжатия gzip (.tar.gz, .tar.tgz, .taz)
• bz2 — сжатие bzip2 (.tar.bz2, .tz2, .tbz2)
• xz — сжатие xz (.tar.xz, TXZ)

archiveFile - Архивный файл для создания
string. Обязательное. Значение по умолчанию: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.

Укажите имя создаваемого архивного файла. Например, чтобы создать foo.tgz:

• Установка типа архива: tar
• Установка сжатия запятой: gz

replaceExistingArchive - Заменить существующие архивные
boolean. Значение по умолчанию: true.

По умолчанию перезаписывает существующий архив. В противном случае, если задано значение false, в существующий архив добавляются несжатые файлы tar.

Поддерживаемые форматы файлов, которые можно добавить в существующий архив:

• zip
• 7z
• tar — только несжатые
• wim

verbose - Принудительное подробное выходных данных
boolean. Значение по умолчанию: false.

Если задано значение true, средства принудительно используют подробные выходные данные. Переопределяет параметр "тихий".

quiet - Принудительное тихое выходных данных
boolean. Значение по умолчанию: false.

Если задано значение true, средства принудительно используют тихие выходные данные. Параметр verbose (или эквивалентный) может переопределить этот параметр.

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

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

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

Нет.

Замечания

Используйте эту задачу для создания архивного файла из исходной папки. Стандартные форматы архивов поддерживаются, включая .zip, .jar, .war, .ear, .tar, .7z и многое другое.

Требования

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