DownloadPipelineArtifact@2 - İşlem Hattı Yapıtları v2 görevini indirme

Makale
07/02/2024

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.

Not

Azure CLI komutları da dahil olmak üzere daha fazla bilgi için bkz. Yapıtları 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.

Önemli

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

Syntax

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

Girişler

buildType - Tarafından üretilen yapıtları indirme
Giriş diğer adı: source. string. Gereklidir. İzin verilen değerler: current (Geçerli çalıştırma), specific (Belirli çalıştırma). 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.

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

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

definition - İşlem hattı oluşturma
Giriş diğer adı: pipeline. string. olduğunda source == specificgereklidir.

İşlem hattının tanım kimliği. Çalışan bir işlem hattında definitionId, System.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. Belirli bir işlem hattı tanımından yapıtları indirmek için bu işlem hattından öğesini yakalayın definitionIdpipeline ve parametresi olarak belirtin.

specificBuildWithTriggering - Uygun olduğunda, tetikleyici derlemesinden yapıtları indirin.
Giriş diğer adı: preferTriggeringPipeline. boolean. İsteğe bağlı. olduğunda source == specifickullanın. Varsayılan değer: false.

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

buildVersionToDownload - İndirecek sürümü oluşturma
Giriş diğer adı: runVersion. string. olduğunda source == specificgereklidir. İzin verilen değerler: latest, latestFromBranch (Belirli daldan en son sürüm ve belirtilen Derleme Etiketleri), specific (Belirli sürüm). Varsayılan değer: latest.

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

branchName - Dal adı
Giriş diğer adı: runBranch. string. olduğunda source == specific && runVersion == latestFromBranchgereklidir. Varsayılan değer: refs/heads/master.

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

pipelineId - Oluşturmak
Giriş diğer adı: runId | buildId. string. olduğunda source == specific && runVersion == specificgereklidir.

Yapıtların indirildiği işlem hattı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 özet sayfasındaki URL'den de alınabilir. Aşağıdaki URL örneğinde buildId 1088: 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 öğesini yakalayın buildIdbuildId ve parametresi olarak belirtin.

tags - Oluşturma Etiketleri
string. İsteğe bağlı. olduğunda source == specific && runVersion != specifickullanın.

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

allowPartiallySucceededBuilds - Kısmen başarılı olan derlemelerden yapıtları indirin.
boolean. İsteğe bağlı. olduğunda source == specific && runVersion != specifickullanın. Varsayılan değer: false.

Derleme görevinin yapıtları indirip indirmediğini, derlemenin başarılı mı yoksa kısmen mi başarılı olduğunu belirtir.

allowFailedBuilds - Başarısız derlemelerden yapıtları indirin.
boolean. İsteğe bağlı. olduğunda source == specific && runVersion != specifickullanın. Varsayılan değer: false.

İşaretlenirse, derleme görevi derlemenin başarılı veya başarısız olmasına bakılmaksızın yapıtları indirir.

artifactName - Yapıt adı
Giriş diğer adı: artifact. 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 desenler
Giriş diğer adı: patterns. 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.

targetPath - Hedef dizin
Giriş diğer adı: path | downloadPath. string. Gereklidir. Varsayılan değer: $(Pipeline.Workspace).

Yapıtların indirileceği aracı makinesinde göreli veya mutlak bir yol belirtir. Çoklu indirme seçeneği uygulanırsa (boş bir yapıt adı bırakılarak), her indirme için bir alt dizin oluşturulur. Azure Pipelines'da Yapıtlar hakkında daha fazla bilgi edinin.

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
İşlem hattı yapıt kaynağının derleme numarasını depolar.

Geriye dönük uyumluluk nedeniyle bu değişken BuildId değerini döndürür.

Derleme değişkenleri hakkında daha fazla bilgi edinin.

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
İşlem hattı yapıt kaynağının derleme numarasını depolar.

Açıklamalar

Önemli

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. Varsayılan olarak, yapıtlar öğesine $(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.

Yayımlama ve indirme anahtar sözcükleri, işlem hattı yapıtlarınızı yayımlamaya ve indirmeye yönelik görev kısayollarıdır.

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. Belirli bir işlem hattı tanımından yapıtları indirmek için bu işlem hattından öğesini yakalayın definitionIdpipeline ve parametresi olarak belirtin.

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

Örnekler

Belirli bir yapıtı indirme

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

Belirli bir projeden/işlem hattından yapıtları indirme

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

Belirli bir daldan yapıtları indirme

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

Belirli bir derleme çalıştırmasından yapıt indirme

# 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

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.164.1 veya üzeri
Görev kategorisi	Yardımcı Program

Aracılığıyla paylaş