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 == specific
gereklidir.
Derleme yapıtlarının indirildiği proje.
pipeline
- derleme işlem hattı
Giriş diğer adı: definition
. string
. olduğunda buildType == specific
gereklidir.
Derleme işlem hattı adını belirtir.
specificBuildWithTriggering
- Uygun olduğunda, yapıtları tetikleyen derlemeden indirin.
boolean
. İsteğe bağlı. when buildType == specific
kullanı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 == specific
gereklidir. İ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ındantags
belirtilen etiketlerin kullanılabilir en son derleme sürümünü indirmeyi seçinlatestFromBranch
. - tarafından
buildId
belirtilen 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 != specific
kullanı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 == latestFromBranch
gereklidir. 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 == specific
gereklidir.
Yapıtları indirmek istediğiniz derleme.
tags
- Derleme Etiketleri
string
. İsteğe bağlı. when buildType == specific && buildVersionToDownload != specific
kullanı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 == single
gereklidir.
İ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 |