ExtractFiles@1 - Mengekstrak tugas file v1

Gunakan tugas ini untuk mengekstrak berbagai file arsip dan kompresi, seperti .7z, .rar, .tar.gz, dan .zip.

Sintaks

# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip' # string. Required. Archive file patterns. Default: **/*.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
    #overwriteExistingFiles: false # boolean. Overwrite existing files. Default: false.
    #pathToSevenZipTool: # string. Path to 7z utility.

Input

archiveFilePatterns - Pola file arsip
string. Wajib diisi. Nilai default: **/*.zip.

Menentukan jalur file atau pola file arsip yang akan diekstrak. Mendukung beberapa baris pola minimatch. Pelajari selengkapnya tentang tugas Ekstrak File.

Menentukan pola yang cocok dengan arsip yang ingin Anda ekstrak. Secara default, pola dimulai di folder akar repositori (sama seperti jika Anda telah menentukan $(Build.SourcesDirectory).
Menentukan filter pola, satu per baris, yang cocok dengan arsip yang akan diekstrak. Contohnya:

• test.zip mengekstrak file test.zip di folder akar.
• test/*.zip mengekstrak semua file .zip dalam folder pengujian.
• **/*.tar mengekstrak semua file .tar di folder akar dan sub-folder.
• **/bin/*.7z mengekstrak semua file .7z di sub-folder apa pun bernama "bin".
  Pola ini digunakan untuk mencocokkan hanya jalur file arsip, bukan jalur folder, dan bukan konten arsip yang akan diekstrak. Jadi, Anda harus menentukan pola, seperti **/bin/** alih-alih **/bin.

destinationFolder - Folder tujuan
string. Wajib diisi.

Menentukan folder tujuan tempat file arsip harus diekstrak. Gunakan variabel jika file tidak ada dalam repositori. Misalnya: $(agent.builddirectory).

cleanDestinationFolder - Bersihkan folder tujuan sebelum mengekstrak
boolean. Nilai default: true.

Menentukan opsi untuk membersihkan direktori tujuan sebelum konten arsip diekstrak ke dalamnya.

overwriteExistingFiles - Timpa file yang ada
boolean. Nilai default: false.

Menentukan opsi untuk menimpa file yang ada di direktori tujuan jika sudah ada. Jika opsinya adalah false, skrip meminta file yang ada, menanyakan apakah Anda ingin menimpanya.

pathToSevenZipTool - Jalur ke utilitas 7z
string.

Menentukan jalur kustom ke utilitas 7z. Misalnya, C:\7z\7z.exe di Windows dan /usr/local/bin/7z di MacOS/Ubuntu. Jika tidak ditentukan pada Windows, versi 7zip default yang disediakan dengan tugas akan digunakan.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugasnya. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Keterangan

Gunakan tugas ini untuk mengekstrak file dari arsip ke folder target menggunakan pola pencocokan. Berbagai format arsip standar didukung, termasuk .zip, .jar, .war, .ear, .tar, .7z, dan banyak lagi.

Untuk informasi selengkapnya tentang pola pencocokan file, lihat Referensi pola pencocokan file.

Contoh

Ekstrak semua file .zip secara rekursif

Contoh ini akan mengekstrak semua file .zip secara rekursif, termasuk file akar dan file dari sub-folder.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Ekstrak semua file .zip dari subfolder

Contoh ini akan mengekstrak test/one.zip dan test/two.zip, tetapi akan meninggalkan test/nested/three.zip.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: 'test/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Tugas ini berjalan menggunakan pembatasan perintah berikut: dibatasi
Variabel yang dapat diatur	Tugas ini memiliki izin untuk mengatur variabel berikut: Variabel pengaturan dinonaktifkan
Versi agen	2.182.1 atau lebih tinggi
Kategori tugas	Utilitas

Lihat juga

• Referensi pola pencocokan file