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。

ルート フォルダー名をアーカイブ内のファイル パスの先頭に追加します。 それ以外の場合、すべてのファイル パスは 1 レベル低く開始されます。

たとえば、ルート フォルダーが の /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、.jar、.war、.ear など、すべての zip 互換の種類に対して選択します
• 7z - 7-Zip 形式、(.7z)
• tar - tar 形式。.tar.gz、.tar.bz2、.tar.xz を含む圧縮 tar に使用します
• wim - wim 形式、.wim

たとえば、 という名前 foo.jarのアーカイブを作成するには、

• 圧縮形式を選択する zip
• 作成するアーカイブ ファイルの名前を指定します。 foo.jar

sevenZipCompression - 7z 圧縮
string. 省略可能。 の場合は archiveType = 7zを使用します。 使用できる値: ultra、maximum、、normal、fast、fastest。 none 既定値: normal。

圧縮レベルを設定するか、 None 圧縮されていない .7z ファイルを作成します。

tarCompression - Tar 圧縮
string. 省略可能。 の場合は archiveType = tarを使用します。 使用できる値: gz、、bz2xz、none。 既定値: gz。

圧縮形式を設定するか、圧縮されていない .tar ファイルを作成することを選択 None します。

• 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" 設定をオーバーライドします。

quiet - 出力を強制的に静かにする
boolean. 既定値: false。

に設定すると true、ツールは強制的にクワイエット出力を使用します。 設定 verbose (またはそれに相当) は、この設定をオーバーライドできます。

タスク コントロール のオプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

このタスクを使用して、ソース フォルダーからアーカイブ ファイルを作成します。 .zip、.jar、.war、.ear、.tar、.7z など、標準のアーカイブ形式がサポートされています。

必要条件

要件	説明
パイプラインの種類	YAML、クラシック ビルド、クラシック リリース
実行日	エージェント、DeploymentGroup
確認要求	なし
Capabilities	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	このタスクは、次の コマンド制限を使用して実行されます。
設定可能な変数	このタスクには、 次の変数を設定するアクセス許可があります。変数の設定は無効です
エージェントのバージョン	2.182.1 以上
タスクのカテゴリ	ユーティリティ