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、、、7ztar。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、fastestnone。 預設值:normal。

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


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

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


工作控制選項

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

輸出變數

沒有。

備註

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

需求

要求 說明
管線類型 YAML、傳統組建、傳統版本
執行於 Agent、DeploymentGroup
需求 沒有
功能 此工作不符合作業中後續工作的任何需求。
命令限制 此工作會使用下列 命令限制執行: 受限制
Settable 變數 此工作有權 設定下列變數:已停用設定變數
代理程式版本 2.182.1 或更新
工作類別 效用