共用方式為


ArchiveFiles@2 - 封存檔 v2 工作

使用壓縮格式封存檔案,例如 .7z、.tar、.gz 和 .zip。

使用壓縮格式封存檔案,例如 .7z、.rar、.tar.、.gz 和 .zip。

Syntax

# 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 、、 7ztarwim 。 預設值:zip

指定壓縮格式。 有效的格式包括:

  • zip -預設。 針對所有 zip 相容類型選擇此格式,例如 .zip、.jar、.war、.ear
  • 7z - 7-Zip 格式, (.7z)
  • tar - tar 格式,用於壓縮的 tars,包括 .tar.gz、.tar.bz2、.tar.xz
  • wim - wim 格式、.wim

範例,建立名為 的 foo.jar 封存:

  • 選取壓縮格式 zip
  • 指定要建立的封存檔案名稱: foo.jar

sevenZipCompression - 7z 壓縮
string. 選擇性。 使用 時機 archiveType = 7z 。 允許的值: ultra 、、 maximumnormalfastfastestnone 。 預設值:normal

設定壓縮層級或 None 建立未壓縮的 .7z 檔案。


sevenZipCompression - 7z 壓縮
string. 選擇性。 使用 時機 archiveType = 7z 。 允許的值: ultra 、、 maximumnormalfastfastestnone 。 預設值:5

設定壓縮格式,或 None 建立未壓縮的 .7z 檔案。


tarCompression - Tar 壓縮
string. 選擇性。 使用 時機 archiveType = tar 。 允許的值: gz 、、 bz2xznone 。 預設值: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 - 強制無訊息輸出
boolean. 預設值:false

如果設定為 true ,會強制工具使用無訊息輸出。 設定 verbose (或對等) 可以覆寫此設定。


工作控制選項

除了工作輸入之外,所有工作都有控制選項。 如需詳細資訊,請參閱 控制項選項和一般工作屬性

輸出變數

無。

備註

使用此工作從來源資料夾建立封存檔案。 支援標準封存格式,包括.zip、.jar、.war、.ear、.tar、.7z 等等。

規格需求

需求 描述
管線類型 YAML、傳統組建、傳統版本
執行于 Agent、DeploymentGroup
要求
Capabilities 此工作不符合作業中後續工作的任何需求。
命令限制 此工作會使用下列 命令限制來執行:受限制
Settable 變數 此工作有權 設定下列變數:已停用設定變數
代理程式版本 2.182.1 或更新版本
工作類別 公用程式
需求 描述
管線類型 YAML、傳統組建、傳統版本
執行于 Agent、DeploymentGroup
要求
Capabilities 此工作不符合作業中後續工作的任何需求。
命令限制 任意
Settable 變數 任意
代理程式版本 所有支援的代理程式版本。
工作類別 公用程式