DownloadPipelineArtifact@1 - Mengunduh tugas artefak alur v1

Gunakan tugas ini untuk mengunduh artefak alur dari tahap sebelumnya dalam alur ini, atau dari alur lain.

Ada versi yang lebih baru dari tugas ini. Untuk informasi selengkapnya, lihat DownloadPipelineArtifact@2.

Catatan

Untuk informasi selengkapnya, termasuk perintah Azure CLI, lihat mengunduh artefak.

Sintaks

# Download Pipeline Artifacts v1
# Download a named artifact from a pipeline to a local path.
- task: DownloadPipelineArtifact@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.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).

Input

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

Mengunduh artefak yang dihasilkan oleh eksekusi alur saat ini atau dari eksekusi alur tertentu.

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

Menentukan nama proyek atau GUID untuk mengunduh artefak alur.

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

ID definisi alur. Dalam alur definitionId yang sedang berjalan, dapat ditemukan dalam variabel System.DefinitionId . definitionId juga dapat diambil dari URL pada halaman gambaran umum alur di portal Azure DevOps. Dalam contoh URL berikut, definitionId adalah 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Untuk mengunduh artefak dari definisi alur tertentu, ambil dari alur tersebut definitionId , dan tentukan sebagai pipeline parameter .

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

Jika dicentang, tugas mengunduh artefak dari build pemicu. Jika tidak ada build pemicu dari alur yang ditentukan, tugas 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 yang akan diunduh.

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

Menentukan filter pada nama cabang/ref. Misalnya: refs/heads/develop.

pipelineId - Membangun
Alias input: buildId. string. Diperlukan saat buildType == specific && buildVersionToDownload == specific.

Pengidentifikasi eksekusi alur untuk mengunduh artefak. Dalam alur buildId yang sedang berjalan, dapat ditemukan di variabel Build.BuildId . buildId juga dapat diambil dari URL pada halaman ringkasan eksekusi alur di portal Azure DevOps. Dalam contoh URL berikut, buildId adalah 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Untuk mengunduh artefak dari eksekusi alur tertentu, ambil dari eksekusi tersebut buildId , dan tentukan sebagai buildId parameter .

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

Daftar tag yang dibatasi koma yang digunakan tugas untuk mengembalikan build yang diberi tag. Build yang tidak diberi tag tidak dikembalikan.

artifactName - Nama artefak
string.

Menentukan nama artefak yang akan diunduh. Jika nilai dibiarkan kosong, tugas mengunduh semua artefak yang terkait dengan eksekusi alur.

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

Pola pencocokan file yang membatasi file yang diunduh. Nilainya bisa satu atau beberapa pola pencocokan file yang dibatasi baris baru. Pelajari selengkapnya tentang pola pencocokan file.

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

Jalur pada mesin agen tempat artefak akan diunduh.

Opsi kontrol tugas

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

Variabel output

Tidak ada.

Keterangan

Ada versi yang lebih baru dari tugas ini. Untuk informasi selengkapnya, lihat DownloadPipelineArtifact@2.

Penting

Tugas ini hanya didukung pada Layanan Azure DevOps. Jika Anda menggunakannya di Azure DevOps Server, Anda akan menerima pesan kesalahan yang mirip Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. dengan Menggunakan Unduh Artefak Build jika Anda menggunakan Azure DevOps Server atau TFS 2018.

Secara default, artefak diunduh ke $(Pipeline.Workspace). Jika Anda tidak menentukan nama artefak, subdirektori akan dibuat untuk setiap artefak yang diunduh. Anda dapat menggunakan pola pencocokan file untuk membatasi file yang ingin Anda unduh.

Bagaimana cara menemukan ID Alur tempat saya ingin mengunduh artefak?

Untuk menemukan definitionId untuk definisi alur tertentu

Dalam alur yang sedang berjalan, definitionId dapat ditemukan dalam variabel System.DefinitionId . definitionId juga dapat diambil dari URL pada halaman gambaran umum alur di portal Azure DevOps. Dalam contoh URL berikut, definitionId adalah 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Untuk mengunduh artefak dari definisi alur tertentu, ambil dari alur tersebut definitionId , dan tentukan sebagai pipeline parameter .

Untuk menemukan buildId untuk eksekusi alur tertentu

Pengidentifikasi eksekusi alur untuk mengunduh artefak. Dalam alur buildId yang sedang berjalan, dapat ditemukan di variabel Build.BuildId . buildId juga dapat diambil dari URL pada halaman ringkasan eksekusi alur di portal Azure DevOps. Dalam contoh URL berikut, buildId adalah 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Untuk mengunduh artefak dari eksekusi alur tertentu, ambil dari eksekusi tersebut buildId , dan tentukan sebagai buildId parameter .

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.155.1 atau lebih tinggi
Kategori tugas	Utilitas