DownloadBuildArtifacts@0 - Unduh tugas build artefak v0

Gunakan tugas ini untuk mengunduh file yang disimpan sebagai artefak dari build yang telah selesai.

Jika Anda menggunakan Azure DevOps Services, sebaiknya gunakan Unduh Artefak Alur dan Terbitkan Artefak Alur untuk performa yang lebih cepat.

Catatan

Nonaktifkan Autentikasi Dasar IIS jika Anda menggunakan Azure DevOps Server untuk mengizinkan autentikasi dengan Token Akses Pribadi Anda. Lihat Autentikasi Dasar IIS dan PATs untuk detail selengkapnya.

Sintaks

# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
  inputs:
    buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when buildType == specific. Project. 
    #pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
    artifactName: # string. Required when downloadType == single. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
    #cleanDestinationFolder: false # boolean. Clean destination folder. Default: false.
  # Advanced
    #parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
    #checkDownloadedFiles: false # boolean. Check downloaded files. Default: false.
    #retryDownloadCount: '4' # string. Retry count. Default: 4.
    #retryRedirectDownloadCount: '0' # string. Retry count for redirect download. Default: 0.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

Input

buildType - Mengunduh artefak yang diproduksi oleh
string. Wajib diisi. Nilai yang diizinkan: current (Build saat ini), specific (Build tertentu). Nilai default: current.

Apakah akan mengunduh artefak yang dihasilkan oleh build saat ini atau dari build tertentu.

project - Proyek
string. Diperlukan saat buildType == specific.

Proyek tempat Anda ingin mengunduh artefak build.

pipeline - Membangun alur
Alias input: definition. string. Diperlukan saat buildType == specific.

Menentukan nama alur build.

specificBuildWithTriggering - Jika sesuai, unduh artefak dari build pemicu.
boolean. Pilihan. Gunakan saat buildType == specific. Nilai default: false.

Jika true, tugas build ini mencoba mengunduh artefak dari build pemicu. Jika tidak ada build pemicu dari alur yang ditentukan, build mengunduh artefak dari build yang ditentukan dalam opsi di bawah ini.

buildVersionToDownload - Versi build untuk diunduh
string. Diperlukan saat buildType == specific. Nilai yang diizinkan: latest, ( latestFromBranch Terbaru dari cabang tertentu dan Tag Build tertentu), specific (Versi tertentu). Nilai default: latest.

allowPartiallySucceededBuilds - Unduh artefak bahkan dari build yang berhasil sebagian.
boolean. Pilihan. Gunakan saat buildType == specific && buildVersionToDownload != specific. Nilai default: false.

Jika true, tugas build ini mencoba mengunduh artefak apakah build berhasil atau sebagian berhasil.

branchName - Nama cabang
string. Diperlukan saat buildType == specific && buildVersionToDownload == latestFromBranch. Nilai default: refs/heads/master.

Menentukan apakah akan memfilter pada nama cabang/ref, misalnya: refs/heads/develop.

buildId - Membangun
string. Diperlukan saat buildType == specific && buildVersionToDownload == specific.

Build yang ingin Anda unduh artefaknya.

tags - Tag Build
string. Opsional. Gunakan saat buildType == specific && buildVersionToDownload != specific.

Daftar tag yang dibatasi koma. Hanya build dengan tag ini yang dikembalikan.

downloadType - Jenis unduhan
string. Wajib diisi. Nilai yang diizinkan: single (Artefak tertentu), specific (File tertentu). Nilai default: single.

Mengunduh artefak tertentu atau file tertentu dari build.

artifactName - Nama artefak
string. Diperlukan saat downloadType == single.

Nama artefak yang akan diunduh.

itemPattern - Pola pencocokan
string. Nilai default: **.

Menentukan file yang akan diunduh sebagai pola minimatch multibaris. Untuk informasi selengkapnya, lihat Referensi pola pencocokan file.

Pola \*\* default mengunduh semua file di semua artefak dalam build jika Anda memilih opsi File tertentu . Untuk mengunduh semua file dalam penurunan artefak, gunakan drop/**.

.

downloadPath - Direktori tujuan
string. Wajib diisi. Nilai default: $(System.ArtifactsDirectory).

Jalur pada mesin agen tempat artefak diunduh.

cleanDestinationFolder - Bersihkan folder tujuan
boolean. Nilai default: false.

Menghapus semua file yang ada di folder tujuan sebelum artefak diunduh.

parallelizationLimit - Batas paralelisasi
string. Nilai default: 8.

Jumlah file yang akan diunduh secara bersamaan.

checkDownloadedFiles - Periksa file yang diunduh
boolean. Nilai default: false.

Jika true, tugas build ini memeriksa bahwa semua file sepenuhnya diunduh.

retryDownloadCount - Jumlah coba lagi
string. Nilai default: 4.

Berapa kali untuk mencoba lagi mengunduh artefak build jika unduhan gagal.

retryRedirectDownloadCount - Jumlah coba lagi untuk unduhan pengalihan
string. Nilai default: 0.

Frekuensi opsional untuk mencoba lagi mengunduh artefak build jika unduhan berdasarkan pengalihan gagal. Jika jaringan Anda tidak mengizinkan mengikuti pengalihan, Anda dapat mengatur ini ke -1 untuk selalu mengunduh respons yang dialirkan dari Azure DevOps sebagai gantinya.

extractTars - Ekstrak semua file yang disimpan di dalam arsip tar
boolean.

Mengekstrak semua file yang diunduh yang memiliki .tar ekstensi. Ini berguna karena Anda perlu mengemas file artefak Anda ke dalam .tar file jika Anda ingin mempertahankan izin file Unix. Mengaktifkan StoreAsTar opsi di tugas PublishBuildArtifacts menyimpan artefak sebagai .tar file secara otomatis.

Opsi kontrol tugas

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

Variabel output

Tugas ini mendefinisikan variabel output berikut, yang dapat Anda konsumsi dalam langkah-langkah hilir, pekerjaan, dan tahapan.

BuildNumber
Menyimpan nomor build sumber artefak build.

Harap dicatat bahwa input ini mengembalikan BuildId karena kompatibilitas mundur. Untuk informasi selengkapnya, lihat Variabel.

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	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	Semua versi agen yang didukung.
Kategori tugas	Utilitas