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 - Добавить имя корневой папки в архивные пути
boolean. Значение по умолчанию: true.

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

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

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

Задает формат сжатия. Допустимые форматы:

• zip -По умолчанию. Выберите этот формат для всех типов, совместимых с ZIP-файлами, таких как .zip, .JAR, .war, .ear
• 7z - Формат 7 Zip, (.7z)
• tar — формат 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, bz2, xz, none. Значение по умолчанию: 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
• Задать сжатие tar: gz

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

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

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

• zip
• 7z
• tar — Только в несжатом режиме
• wim

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

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

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

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

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

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

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

Нет.

Remarks

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

Требования

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