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 = filepath
gereklidir.
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 = filepath
kullanı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 = true
kullanı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:
- İşlem hattınızı düzenleyin ve Değişkenler'i seçin
- Ad
System.Debug
ve değerle yeni bir değişken eklemetrue
- 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.
- Derleme yapıtlarını kullanmaya başlamak mı arıyorsunuz? Bkz. Azure Pipelines'da yapıtlar.