Share via


PublishPipelineArtifact@1 - İşlem Hattı Yapıtlarını Yayımlama v1 görevi

Geçerli çalıştırma için bir dosyayı veya dizini adlandırılmış yapıt olarak yayımlamak (karşıya yüklemek) için bu görevi kullanın.

Geçerli çalıştırma için bir dosyayı veya dizini adlandırılmış yapıt olarak yayımlamak (karşıya yüklemek) için bu görevi kullanın.

Önemli

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

Syntax

# Publish Pipeline Artifacts v1
# Publish (upload) a file or directory as a named artifact for the current run.
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path. Required. File or directory path. Default: $(Pipeline.Workspace).
    #artifact: # string. Alias: artifactName. Artifact name. 
    publishLocation: 'pipeline' # 'pipeline' | 'filepath'. Alias: artifactType. Required. Artifact publish location. Default: pipeline.
    #fileSharePath: # string. Required when artifactType = filepath. File share path. 
    #parallel: false # boolean. Optional. Use when artifactType = filepath. Parallel copy. Default: false.
    #parallelCount: '8' # string. Optional. Use when artifactType = filepath && parallel = true. Parallel count. Default: 8.
    #properties: # string. Custom properties.
# Publish Pipeline Artifacts v1
# Publish (upload) a file or directory as a named artifact for the current run.
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path. Required. File or directory path. Default: $(Pipeline.Workspace).
    #artifact: # string. Alias: artifactName. Artifact name. 
    publishLocation: 'pipeline' # 'pipeline' | 'filepath'. Alias: artifactType. Required. Artifact publish location. Default: pipeline.
    #fileSharePath: # string. Required when artifactType = filepath. File share path. 
    #parallel: false # boolean. Optional. Use when artifactType = filepath. Parallel copy. Default: false.
    #parallelCount: '8' # string. Optional. Use when artifactType = filepath && parallel = true. Parallel count. Default: 8.

Girişler

targetPath - Dosya veya dizin yolu
Giriş diğer adı: path. string. Gereklidir. Varsayılan değer: $(Pipeline.Workspace).

Yayımlayacak dosyanın veya dizinin yolunu belirtir. Mutlak veya varsayılan çalışma dizinine göre olabilir. Değişkenleri içerebilir, ancak joker karakterler desteklenmez. Daha fazla bilgi için bkz. Azure Pipelines'da yapıtlar .


artifact - Yapıt adı
Giriş diğer adı: artifactName. string.

Yayımlayacak yapıtın adını belirtir. Seçtiğiniz herhangi bir ad olabilir, örneğin drop. Ayarlanmadıysa, varsayılan değer iş kapsamına sahip benzersiz bir kimliktir.

Önemli

Yapıt adı , , /, ", :, <, >, |*veya ?içeremez\.


publishLocation - Yapıt yayımlama konumu
Giriş diğer adı: artifactType. string. Gereklidir. İzin verilen değerler: pipeline (Azure Pipelines), filepath (Dosya paylaşımı). Varsayılan değer: pipeline.

Yapıtın Azure Pipelines'da depolanmasını veya işlem hattı aracısından erişilebilir olması gereken bir dosya paylaşımına kopyalanıp kopyalanmayacağını belirtir.


fileSharePath - Dosya paylaşım yolu
string. olduğunda artifactType = filepathgereklidir.

Yapıt dosyalarının kopyalandığı dosya paylaşımını belirtir. Bu, örneğin \\my\\share\\$(Build.DefinitionName)\\$(Build.BuildNumber)değişkenlerini içerebilir. Linux veya macOS aracısından dosya paylaşımına yapıt yayımlama desteklenmez, örneğin \\server\folderName.


parallel - Paralel kopyalama
boolean. İsteğe bağlı. when artifactType = filepathkullanın. Varsayılan değer: false.

Daha yüksek potansiyel aktarım hızı için birden çok iş parçacığı kullanarak dosyaların paralel olarak kopyalanıp kopyalanmayacağını belirtir. Bu ayar etkin değilse, bir iş parçacığı kullanılır.


parallelCount - Paralel sayı
string. İsteğe bağlı. when artifactType = filepath && parallel = truekullanın. Varsayılan değer: 8.

Paralellik derecesini veya kopyayı gerçekleştirmek için kullanılan iş parçacığı sayısını belirtir. Değer 1 ile 128 arasında olmalıdır.


properties - Özel özellikler
string.

Yapıtla ilişkilendirilecek özel özellikleri belirtir. Tüm anahtarlarda ön ekiyle user- geçerli bir JSON dizesi kullanın.


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

Yok.

Açıklamalar

Yayımlama, klasik yayın işlem hatlarında desteklenmez.

Not

İşlem Hattı Yapıtlarını Yayımlama, şirket içinde desteklenmez. Azure DevOps Server veya TFS 2018 kullanıyorsanız lütfen Derleme Yapıtlarını Yayımla'yı kullanın. Azure DevOps Server kullanıyorsanız, benzeri Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead.bir hata iletisi alırsınız.

publish ve download anahtar sözcükleri, PublishPipelineArtifact@1 ve DownloadPipelineArtifact@2 görevleri için kısayollardır. Diğer ayrıntılar için bkz. steps.publish ve steps.download .

İpucu

Hangi dosyaların yayımlandığını denetlemek için .artifactignore dosyasını kullanabilirsiniz.

Yapıtlarımı yayımlama konusunda sorun yaşıyorum. Ayrıntılı günlükleri nasıl görüntüleyebilirim?

İşlem hattınız için ayrıntılı günlükleri etkinleştirmek için:

  1. İşlem hattınızı düzenleyin ve Değişkenler'i seçin
  2. Ad System.Debug ve değerle yeni bir değişken ekleme true
  3. Kaydet

Hangi değişkenler benim için kullanılabilir?

Y: $(Build.SourcesDirectory) ve $(Agent.BuildDirectory) işlem hattınızda kullanabileceğiniz değişkenlerden yalnızca birkaçıdır. Değişkenler ifade veya betik olarak kullanılabilir.

Farklı değişken türleri hakkında bilgi edinmek için bkz. Değişkenleri, önceden tanımlanmış değişkenlerive Klasik sürüm ve yapıt değişkenlerini tanımlama.

Görev, yaml işlem hattında dağıtım işinde yapıtları yayımlamama izin veriyor, ancak bunu aşağı akış işlem hattında kullanamıyor muyum?

Y: Dağıtım işleri kaynak dalların bağlamını içermez ve bu nedenle yapıtları yayımlamak için uygun değildir. Bunlar öncelikli olarak yapıtları kullanacak şekilde tasarlanmıştır. Geçici çözüm, bu mantığı ayrı bir işe ayırmaktır (dağıtım işleriniz üzerindeki bağımlılıklarla).

Gereksinimler

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Agent, DeploymentGroup
Talep Hiçbiri
Özellikler Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları Herhangi biri
Ayarlanabilir değişkenler Herhangi biri
Aracı sürümü 2.199.0 veya üzeri
Görev kategorisi Yardımcı Program
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.199 veya üzeri
Görev kategorisi Yardımcı Program
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.159.2 veya üzeri
Görev kategorisi Yardımcı Program

Ayrıca bkz.