DownloadBuildArtifacts@1 - Unduh tugas build artefak v1

Artikel
04/29/2024

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.

Sintaks

# Download build artifacts v1
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@1
  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.
    #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 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 akan 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.

Menentukan versi build mana yang akan diunduh.

Pilih latest untuk mengunduh versi build terbaru yang tersedia.
Pilih latestFromBranch untuk mengunduh versi build terbaru yang tersedia dari cabang yang ditentukan oleh branchName dan tag yang ditentukan oleh tags.
Pilih specific untuk mengunduh versi build yang ditentukan oleh buildId.

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 tempat Anda ingin mengunduh artefak.

tags - Tag Build
string. Pilihan. 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.

Pilih single (Artefak tertentu) jika Anda hanya menginginkan satu artefak tertentu yang ditentukan oleh artifactName
Pilih specific (File tertentu) saat Anda menginginkan semua artefak dari build yang dipilih

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 penghilangan 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.

Hapus semua file yang ada di folder tujuan sebelum pengunduhan artefak.

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 diunduh sepenuhnya.

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

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

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

Atur ke true untuk mengekstrak semua file yang diunduh yang memiliki ekstensi .tar . Ini berguna karena Anda perlu mengemas file artefak Anda ke dalam tar jika Anda ingin mempertahankan izin file Unix. Mengaktifkan StoreAsTar opsi dalam tugas Terbitkan artefak build akan menyimpan artefak sebagai file .tar 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 menentukan 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.

Keterangan

Catatan

Tim Azure Pipelines merekomendasikan peningkatan dari artefak build ke Artefak Alur untuk performa yang lebih cepat.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	2.191.1 atau lebih tinggi
Kategori tugas	Utilitas