ArchiveFiles@2 - 存档文件 v2 任务

使用压缩格式(如 .7z、.tar、.gz 和 .zip)存档文件。

使用压缩格式(如 .7z、.rar、.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.
# 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: '5' # 'ultra' | 'maximum' | 'normal' | 'fast' | 'fastest' | 'none'. Optional. Use when archiveType = 7z. 7z compression. Default: 5.
    #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.
# 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.
    #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.
# Archive Files v2
# Archive files using compression formats such as .7z, .rar, .tar.gz, and .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.
    #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.

输入

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. 必需。 允许的值:zip7z、、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使用 。 允许的值:ultramaximum、、normalfastfastestnone。 默认值:normal

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


sevenZipCompression - 7z 压缩
string. 可选。 在 时 archiveType = 7z使用 。 允许的值:ultramaximum、、normalfastfastestnone。 默认值:5

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


tarCompression - Tar 压缩
string. 可选。 在 时 archiveType = tar使用 。 允许的值:gzbz2、、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 或更高版本
任务类别 实用工具
要求 说明
管道类型 YAML、经典版本、经典版本
运行平台 Agent、DeploymentGroup
需求
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置变量 任意
代理版本 所有支持的代理版本。
任务类别 实用工具