DownloadPipelineArtifact@1 - İşlem hattı yapıtı v1 görevini indirme

Bu görevi, bu işlem hattının önceki aşamalarından veya başka bir işlem hattından işlem hattı yapıtlarını indirmek için kullanın.

Bu görevin daha yeni bir sürümü var. Daha fazla bilgi için bkz. DownloadPipelineArtifact@2.

Uyarı

Azure CLI komutları da dahil olmak üzere daha fazla bilgi için bkz. yapıtları indirme.

Sözdizimi

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

Girişler

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

Geçerli işlem hattı çalıştırması tarafından veya belirli bir işlem hattı çalıştırmasından üretilen yapıtları indirir.

projectproject -
string. buildType == specificgerekir.

İşlem hattı yapıtlarının indirildiği proje adını veya GUID'yi belirtir.

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

İşlem hattının tanım kimliği. Çalışan bir işlem hattında definitionIdSystem.DefinitionId değişkeninde bulunabilir. definitionId, Azure DevOps portalındaki işlem hattına genel bakış sayfasındaki URL'den de alınabilir. Aşağıdaki URL örneğinde definitionId 78'dir: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Yapıtları belirli bir işlem hattı tanımından indirmek için bu işlem hattından definitionId yakalayın ve pipeline parametresi olarak belirtin.

specificBuildWithTriggering - Uygun olduğunda, tetikleme derlemesinden yapıtları indirin.
boolean. Opsiyonel. buildType == specificolduğunda kullanın. Varsayılan değer: false.

İşaretlenirse, görev tetikleyici derlemesinden yapıtları indirir. Belirtilen işlem hattından tetikleyen derleme yoksa, görev aşağıdaki seçeneklerde belirtilen derlemeden yapıtları indirir.

indirmek için Derleme sürümünü buildVersionToDownload -
string. buildType == specificgerekir. İzin verilen değerler: latest, latestFromBranch (Belirli daldan ve belirtilen Derleme Etiketlerinden en son), specific (Belirli sürüm). Varsayılan değer: latest.

İndirilmesi gereken derleme sürümünü belirtir.

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

Dal/başvuru adı üzerindeki filtreyi belirtir. Örneğin: refs/heads/develop.

pipelineId - Oluşturma
Giriş diğer adı: buildId. string. buildType == specific && buildVersionToDownload == specificgerekir.

Yapıtların indirildiği işlem hattı çalıştırmasının tanımlayıcısı. Çalışan bir işlem hattında buildIdBuild.BuildId değişkeninde bulunabilir. buildId, Azure DevOps portalındaki işlem hattı çalıştırma özeti sayfasındaki URL'den de alınabilir. Aşağıdaki URL örneğinde buildId 1088'dir: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Belirli bir işlem hattı çalıştırmasından yapıtları indirmek için, bu çalıştırmadan buildId yakalayın ve buildId parametresi olarak belirtin.

tags - Oluşturma Etiketleri
string. Opsiyonel. buildType == specific && buildVersionToDownload != specificolduğunda kullanın.

Görevin etiketli derlemeleri döndürmek için kullandığı etiketlerin virgülle ayrılmış listesi. Etiketlenmemiş derlemeler döndürülmüyor.

artifactName - Yapıt adı
string.

İndirilmesi gereken yapıtın adını belirtir. Değer boş bırakılırsa, görev işlem hattı çalıştırmasıyla ilişkili tüm yapıtları indirir.

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

İndirilen dosyaları sınırlayan dosya eşleştirme desenleri. Değer, yeni satır sınırlandırılmış bir veya daha fazla dosya eşleştirme deseni olabilir. dosya eşleştirme desenleri hakkında daha fazla bilgi edinin.

hedef dizin
Giriş diğer adı: downloadPath. string. Gerekli. Varsayılan değer: $(System.ArtifactsDirectory).

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

Görev denetimi seçenekleri

Tüm görevlerin, 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

Yok.

Açıklamalar

Bu görevin daha yeni bir sürümü var. Daha fazla bilgi için bkz. DownloadPipelineArtifact@2.

Önemli

Bu görev yalnızca Azure DevOps Services'ta desteklenir. Azure DevOps Server'da kullanıyorsanız, Azure DevOps Server veya TFS 2018 kullanıyorsanız Derleme Yapıtlarını Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. kullan benzer bir hata iletisi alırsınız.

Varsayılan olarak, yapıtlar $(Pipeline.Workspace)indirilir. Yapıt adı belirtmezseniz, indirilen her yapıt için bir alt dizin oluşturulur. İndirmek istediğiniz dosyaları sınırlamak için dosya eşleştirme desenlerini kullanabilirsiniz.

Bir yapıtı indirmek istediğim İşlem Hattının kimliğini nasıl bulabilirim?

Belirli bir işlem hattı tanımının definitionId değerini bulmak için

Çalışan bir işlem hattında, definitionIdSystem.DefinitionId değişkeninde bulunabilir. definitionId, Azure DevOps portalındaki işlem hattına genel bakış sayfasındaki URL'den de alınabilir. Aşağıdaki URL örneğinde definitionId 78'dir: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Yapıtları belirli bir işlem hattı tanımından indirmek için bu işlem hattından definitionId yakalayın ve pipeline parametresi olarak belirtin.

Belirli bir işlem hattı çalıştırmasının buildId değerini bulmak için

Yapıtların indirildiği işlem hattı çalıştırmasının tanımlayıcısı. Çalışan bir işlem hattında buildIdBuild.BuildId değişkeninde bulunabilir. buildId, Azure DevOps portalındaki işlem hattı çalıştırma özeti sayfasındaki URL'den de alınabilir. Aşağıdaki URL örneğinde buildId 1088'dir: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Belirli bir işlem hattı çalıştırmasından yapıtları indirmek için, bu çalıştırmadan buildId yakalayın ve buildId parametresi olarak belirtin.

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Agent, DeploymentGroup
Talepleri	Hiç kimse
Özellikleri	Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları	Herhangi bir
Ayarlanabilir değişkenleri	Herhangi bir
Aracı sürümü	2.155.1 veya üzeri
Görev kategorisi	Fayda