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、、tarwim。 默认值：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、fastfastest、none。 默认值：normal。

设置压缩级别 或 None 以创建未压缩的 .7z 文件。

tarCompression - Tar 压缩
string. 可选。 在 时 archiveType = tar使用 。 允许的值：gz、bz2、、xznone。 默认值：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、经典版本、经典版本
运行平台	Agent、DeploymentGroup
需求	无
功能	此任务不满足作业中后续任务的任何要求。
命令限制	此任务使用以下命令 限制运行：受限
可设置变量	此任务有权 设置以下变量：已禁用设置变量
代理版本	2.182.1 或更高版本
任务类别	实用工具