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 或更新
工作類別	效用