ArchiveFiles@2 - 存档文件 v2 任务

使用压缩格式（如.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 设置（或等效设置）可以替代此设置。

任务控制选项

除任务输入之外，所有任务都具有控制选项。 有关详细信息，请参阅 控件选项和常见任务属性。

输出变量

没有。

注解

使用此任务从源文件夹创建存档文件。 支持标准存档格式，包括 .zip、.jar、.war、.ear、.tar、.7z等。

要求

要求	说明
管道类型	YAML，经典版本，经典版本
运行时间	代理，DeploymentGroup
需求	没有
功能	此任务不满足作业中后续任务的任何要求。
命令限制	此任务使用以下 命令限制运行： 受限
Settable 变量	此任务有权 设置以下变量：禁用设置变量
代理版本	2.182.1 或更高版本
任务类别	效用