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、7z、tar、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、bz2、xz、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" 設定をオーバーライドします。

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

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

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

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

出力変数

なし。

注釈

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

必要条件

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