DownloadPipelineArtifact@2 - Unduh tugas Artefak Alur v2

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

Catatan

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

Sintaks

# Download Pipeline Artifacts v2
# Download build and pipeline artifacts.
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'current' # 'current' | 'specific'. Alias: source. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when source == specific. Project. 
    #definition: # string. Alias: pipeline. Required when source == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Alias: preferTriggeringPipeline. Optional. Use when source == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Alias: runVersion. Required when source == specific. Build version to download. Default: latest.
    #branchName: 'refs/heads/master' # string. Alias: runBranch. Required when source == specific && runVersion == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: runId | buildId. Required when source == specific && runVersion == specific. Build. 
    #tags: # string. Optional. Use when source == specific && runVersion != specific. Build Tags. 
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from partially succeeded builds. Default: false.
    #allowFailedBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from failed builds. Default: false.
    #artifactName: # string. Alias: artifact. Artifact name. 
    #itemPattern: '**' # string. Alias: patterns. Matching patterns. Default: **.
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path | downloadPath. Required. Destination directory. Default: $(Pipeline.Workspace).

Input

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

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

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

Menentukan nama proyek atau GUID untuk mengunduh artefak alur.

definition - Membangun alur
Alias input: pipeline. string. Diperlukan saat source == 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 definitionIdpipeline , dan tentukan sebagai parameter .

specificBuildWithTriggering - Jika sesuai, unduh artefak dari build pemicu.
Alias input: preferTriggeringPipeline. boolean. Pilihan. Gunakan saat source == 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
Alias input: runVersion. string. Diperlukan saat source == 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
Alias input: runBranch. string. Diperlukan saat source == specific && runVersion == latestFromBranch. Nilai default: refs/heads/master.

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

pipelineId - Membangun
Alias input: runId | buildId. string. Diperlukan saat source == specific && runVersion == 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 buildIdbuildId , dan tentukan sebagai parameter .

tags - Tag Build
string. Opsional. Gunakan saat source == specific && runVersion != specific.

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

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

Menentukan apakah tugas build mengunduh artefak apakah build berhasil atau sebagian berhasil.

allowFailedBuilds - Unduh artefak dari build yang gagal.
boolean. Pilihan. Gunakan saat source == specific && runVersion != specific. Nilai default: false.

Jika dicentang, tugas build mengunduh artefak apakah build berhasil atau gagal.

artifactName - Nama artefak
Alias input: artifact. string.

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

itemPattern - Pola pencocokan
Alias input: patterns. 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: path | downloadPath. string. Wajib diisi. Nilai default: $(Pipeline.Workspace).

Menentukan jalur relatif atau absolut pada mesin agen tempat artefak akan diunduh. Jika opsi multi-unduh diterapkan (dengan meninggalkan nama artefak kosong), subdirektori akan dibuat untuk setiap unduhan. Pelajari selengkapnya tentang Artefak di Azure Pipelines.

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

Karena kompatibilitas mundur, variabel ini mengembalikan BuildId.

Pelajari selengkapnya tentang variabel build.

Keterangan

Penting

Tugas ini hanya didukung di Azure DevOps Services. 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 Gunakan Unduh Artefak Build jika Anda menggunakan Azure DevOps Server atau TFS 2018.

Gunakan tugas ini untuk mengunduh artefak alur dari tahap sebelumnya dalam alur ini, atau dari alur lain. 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.

Kata kunci publikasi dan unduh adalah pintasan tugas untuk menerbitkan dan mengunduh artefak alur Anda.

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 definitionIdpipeline , dan tentukan sebagai 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 buildIdbuildId , dan tentukan sebagai parameter .

Contoh

Mengunduh artefak tertentu

# Download an artifact named 'WebApp' to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
  inputs:
    artifactName: 'WebApp'
    targetPath: $(Build.SourcesDirectory)/bin

Mengunduh artefak dari proyek/alur tertentu

# Download artifacts from a specific pipeline.
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'latest'

Mengunduh artefak dari cabang tertentu

# Download artifacts from a specific branch with a tag
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'latestFromBranch'
    branchName: 'refs/heads/master'
    tags: 'testTag'

Mengunduh artefak dari eksekusi build tertentu

# Download an artifact named 'WebApp' from a specific build run to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
  inputs:
    buildType: 'specific'
    artifactName: 'WebApp'
    targetPath: $(Build.SourcesDirectory)/bin
    project: 'FabrikamFiber'
    definition: 12
    buildVersionToDownload: 'specific'
    pipelineId: 40

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