ArchiveFiles@1 - 封存檔案 v1 工作

發行項
04/29/2024

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

Syntax

# Archive Files v1
# Archive files using compression formats such as .7z, .rar, .tar.gz, and .zip.
- task: ArchiveFiles@1
  inputs:
    rootFolder: '$(Build.BinariesDirectory)' # string. Required. Root folder (or file) to archive. Default: $(Build.BinariesDirectory).
    #includeRootFolder: true # boolean. Prefix root folder name to archive paths. Default: true.
  # Archive
    archiveType: 'default' # 'default' | '7z' | 'tar' | 'wim'. Required. Archive type. Default: default.
    #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.

輸入

rootFolder - 要封存的根資料夾 (或檔案)
string. 必要。預設值：$(Build.BinariesDirectory)。

要封存的根資料夾或檔案名稱。對於資料夾，具名資料夾中的所有專案會新增至封存。

includeRootFolder - 封存路徑的根資料夾名稱前置詞
boolean. 預設值：true。

根據預設，在封存內的檔案路徑前面加上根資料夾名稱。當設定為 false 時，所有檔案路徑都會從較低層級開始。

例如，如果根資料夾路徑為： /home/user/output/classes/ 和檔案路徑 com/acme/Main.class 。產生的封存將包含 classes/com/acme/Main.class 。否則，產生的封存將會包含 com/acme/Main.class 。

archiveType - 封存類型
string. 必要。允許的值： default (zip) 、 7z 、、 tarwim 。預設值：default。

指定壓縮格式。

例如，若要建立名為的 foo.jar 封存：

設定壓縮格式： zip
設定封存名稱： foo.jar

針對所有 tar 檔案 (包括壓縮檔) ，請選擇 tar 。

tarCompression - Tar 壓縮
string. 選擇性。使用時 archiveType = tar 。允許的值： gz 、、 bz2xz 、 none 。預設值：gz。

選取壓縮配置，或 none 建立未壓縮的 tar 檔案。

archiveFile - 要建立的封存檔案
string. 必要。預設值：$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip。

指定要建立的封存檔案名稱。

例如，若要建立 foo.tgz ：

設定封存類型： tar
設定 tar 壓縮： gz

replaceExistingArchive - 取代現有的封存
boolean. 預設值：true。

覆寫現有的封存。如果未指定，則會將檔案新增至封存。

工作控制項選項

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

輸出變數

無。

備註

有較新版本的封存檔工作可用。

封存檔案 v2

規格需求

需求	描述
管線類型	YAML、傳統組建、傳統版本
在上執行	Agent、DeploymentGroup
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任意
可設定變數	任意
代理程式版本	所有支援的代理程式版本。
工作類別	公用程式

另請參閱

封存檔案 v2