ArchiveFiles@2 - 封存檔 v2 工作

使用壓縮格式封存檔案，例如 .7z、.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.

輸入

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 格式，用於壓縮的 tars，包括 .tar.gz、.tar.bz2、.tar.xz
• wim - wim 格式、.wim

範例，建立名為 的 foo.jar 封存：

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

sevenZipCompression - 7z 壓縮
string. 選擇性。 使用 時機 archiveType = 7z 。 允許的值： ultra 、、 maximum 、 normalfast 、 fastest 、 none 。 預設值：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
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	此工作會使用下列 命令限制來執行：受限制
Settable 變數	此工作有權 設定下列變數：已停用設定變數
代理程式版本	2.182.1 或更新版本
工作類別	公用程式