DownloadBuildArtifacts@1 - Derleme yapıtları v1 görevini indirme

Tamamlanmış bir derlemenin yapıtları olarak kaydedilmiş dosyaları indirmek için bu görevi kullanın.

Azure DevOps Services kullanıyorsanız daha hızlı performans için İşlem Hattı Yapıtlarını İndirme ve İşlem Hattı Yapıtlarını Yayımlama'yı kullanmanızı öneririz.

Syntax

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

Girişler

buildType - Tarafından üretilen yapıtları indirme
string. Gereklidir. İzin verilen değerler: current (Geçerli derleme), specific (Belirli derleme). Varsayılan değer: current.

Geçerli derleme tarafından veya belirli bir derlemeden üretilen yapıtların indirilip indirilmeyeceği.


project - Proje
string. olduğunda buildType == specificgereklidir.

Derleme yapıtlarının indirildiği proje.


pipeline - derleme işlem hattı
Giriş diğer adı: definition. string. olduğunda buildType == specificgereklidir.

Derleme işlem hattı adını belirtir.


specificBuildWithTriggering - Uygun olduğunda, yapıtları tetikleyen derlemeden indirin.
boolean. İsteğe bağlı. when buildType == specifickullanın. Varsayılan değer: false.

ise true, bu derleme görevi tetikleyici derlemeden yapıtları indirmeye çalışır. Belirtilen işlem hattından tetikleyen derleme yoksa, yapıtları aşağıdaki seçeneklerde belirtilen derlemeden indirir.


buildVersionToDownload - İndirecek derleme sürümü
string. olduğunda buildType == specificgereklidir. İzin verilen değerler: latest, latestFromBranch (Belirli daldan ve belirtilen Derleme Etiketlerinden en son sürüm), specific (Belirli sürüm). Varsayılan değer: latest.

Derlemenin indirilmesi gereken sürümü belirtir.

  • Kullanılabilir en son derleme sürümünü indirmeyi seçin latest .
  • tarafından branchName belirtilen dalın ve tarafından tagsbelirtilen etiketlerin kullanılabilir en son derleme sürümünü indirmeyi seçinlatestFromBranch.
  • tarafından buildIdbelirtilen derleme sürümünü indirmeyi seçinspecific.

allowPartiallySucceededBuilds - Kısmen başarılı derlemelerden bile yapıtları indirin.
boolean. İsteğe bağlı. when buildType == specific && buildVersionToDownload != specifickullanın. Varsayılan değer: false.

ise true, bu derleme görevi derlemenin başarılı mı yoksa kısmen mi başarılı olduğuyla ilgili yapıtları indirmeye çalışır.


branchName - Dal adı
string. olduğunda buildType == specific && buildVersionToDownload == latestFromBranchgereklidir. Varsayılan değer: refs/heads/master.

Dal/başvuru adına göre filtreleme yapılıp yapılmayacağını belirtir, örneğin: refs/heads/develop.


buildId - Oluşturmak
string. olduğunda buildType == specific && buildVersionToDownload == specificgereklidir.

Yapıtları indirmek istediğiniz derleme.


tags - Derleme Etiketleri
string. İsteğe bağlı. when buildType == specific && buildVersionToDownload != specifickullanın.

Virgülle ayrılmış etiket listesi. Yalnızca bu etiketlere sahip derlemeler döndürülür.


downloadType - İndirme türü
string. Gereklidir. İzin verilen değerler: single (Belirli yapıt), specific (Belirli dosyalar). Varsayılan değer: single.

Derlemeden belirli bir yapıtı veya belirli dosyaları indirir.

  • single (Belirli yapıt) öğesini, yalnızca bir özel yapıtın belirterekartifactName
  • specific Seçili derlemenin tüm yapıtlarını istediğinizde (Belirli dosyalar) seçeneğini belirleyin

artifactName - Yapıt adı
string. olduğunda downloadType == singlegereklidir.

İndirilmesi gereken yapıtın adı.


itemPattern - Eşleşen desen
string. Varsayılan değer: **.

İndirilmesi gereken dosyaları çok satırlı bir minimatch deseni olarak belirtir. Daha fazla bilgi için bkz . Dosya eşleştirme desenleri başvurusu.

Belirli dosyalar seçeneğini belirlerseniz, varsayılan düzen \*\* derlemedeki tüm yapıtlardaki tüm dosyaları indirir. Yapıt bırakma içindeki tüm dosyaları indirmek için kullanın drop/**.


downloadPath - Hedef dizin
string. Gereklidir. Varsayılan değer: $(System.ArtifactsDirectory).

Aracı makinesinde yapıtların indirildiği yol.


cleanDestinationFolder - Hedef klasörü temizleme
boolean. Varsayılan değer: false.

Yapıt indirilmeden önce hedef klasördeki tüm mevcut dosyaları silin.


parallelizationLimit - Paralelleştirme sınırı
string. Varsayılan değer: 8.

Aynı anda indirilmesi gereken dosya sayısı.


checkDownloadedFiles - İndirilen dosyaları denetleme
boolean. Varsayılan değer: false.

ise true, bu derleme görevi tüm dosyaların tam olarak indirilip indirilmediğini denetler.


retryDownloadCount - Yeniden deneme sayısı
string. Varsayılan değer: 4.

İndirme başarısız olursa derleme yapıtı indirmeyi yeniden deneme sayısı.


extractTars - Tar arşivlerinde depolanan tüm dosyaları ayıklama
boolean.

true.tar uzantısına sahip tüm indirilen dosyaları ayıklamak için olarak ayarlayın. Unix dosya izinlerini korumak istiyorsanız yapıt dosyalarınızı tar içinde paketlemeniz gerektiğinden bu yararlı olur. Derleme yapıtlarını yayımla görevinde seçeneği etkinleştirildiğinde StoreAsTar yapıtlar otomatik olarak .tar dosyaları olarak depolanır.


Görev denetim seçenekleri

Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Bu görev aşağı akış adımlarında, işlerde ve aşamalarda kullanabileceğiniz aşağıdaki çıkış değişkenlerini tanımlar.

BuildNumber
Derleme yapıtı kaynağının derleme numarasını depolar.

Bu girişin geriye dönük uyumluluk nedeniyle BuildId döndürdüğünü lütfen unutmayın. Daha fazla bilgi için bkz. Değişkenler.

Açıklamalar

Not

Azure Pipelines ekibi, daha hızlı performans için derleme yapıtlarındanİşlem Hattı Yapıtlarına yükseltmenizi önerir.

Gereksinimler

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalıştırılır Agent, DeploymentGroup
Talep Hiçbiri
Özellikler Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Herhangi biri
Ayarlanabilir değişkenler Herhangi biri
Aracı sürümü 2.191.1 veya üzeri
Görev kategorisi Yardımcı Program