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
. 必需。 允许的值:zip
、7z
、、tar
wim
。 默认值:zip
。
指定压缩格式。 有效格式包括:
zip
-默认。 为所有 zip 兼容类型(如 .zip、.jar、.war、.ear)选择此格式7z
- 7-Zip 格式, (.7z)tar
- tar 格式,用于压缩的 tar,包括 .tar.gz、.tar.bz2、.tar.xzwim
- wim 格式,.wim
例如,创建名为 的 foo.jar
存档:
- 选择压缩格式
zip
- 指定要创建的存档文件的名称:
foo.jar
sevenZipCompression
- 7z 压缩
string
. 可选。 在 时 archiveType = 7z
使用 。 允许的值:ultra
、maximum
、、normal
、fast
fastest
、none
。 默认值:normal
。
设置压缩级别 或 None
以创建未压缩的 .7z 文件。
sevenZipCompression
- 7z 压缩
string
. 可选。 在 时 archiveType = 7z
使用 。 允许的值:ultra
、maximum
、、normal
、fast
fastest
、none
。 默认值:5
。
设置压缩格式或 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 等。