Azure Pipelines'Universal Packages yayımlama ve indirme

Azure Pipelines

Bu Universal Packages istediğiniz sayıda dosya paketine sahip olabilir ve bunu takımınız ile paylaşabilirsiniz. Evrensel Paket görevini kullanarak, 4 TB'a kadar çeşitli boyutlardaki paketleri pakete, yayımlayın ve indirebilirsiniz. Her paket benzersiz olarak bir ad ve sürüm numarası ile tanımlanır. Paketler, Azure CLI veya Artifacts akışlara yayımlanır ve bu akışlardan Azure Pipelines.

Not

Universal Packages yalnızca Azure DevOps Services.

Evrensel Paket Hazırlama

Varsayılan olarak, Universal Packages yayımlama dizini $(Build.ArtifactStagingDirectory) olarak kullanır. Evrensel Paketinizi yayımlamaya hazırlamak için, yayımlamak istediğiniz dosyaları bu dizine yer. Bu dosyaları yayımlama dizinine kopyalamak için Dosyaları Kopyala yardımcı programını da kullanabilirsiniz.

Evrensel Paket Yayımlama

Genel akış akışınıza bir Evrensel Artifacts yayımlamak için, işlem hattınıza yaml dosyasına aşağıdaki görevi ekleyin.

# Publish a Universal Package
- task: UniversalPackages@0
  displayName: Universal Publish
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'
    vstsFeedPublish: '<projectName>/<feedName>'
    vstsFeedPackagePublish: '<Package name>'
    packagePublishDescription: '<Package description>'
Bağımsız Değişken Description
publishDirectory Yayımlanacak dosyaların konumu.
vstsFeedPublish Yayımlayacak proje ve akış adı.
vstsFeedPackagePublish Paket adı. Küçük harfli olması gerekir. Yalnızca harf, sayı ve tire kullanın.
packagePublishDescription Paketin içeriğinin açıklaması.

Paketleri işlem hattınız Azure Artifacts akışında yayımlamak için, Project Koleksiyon Derleme Hizmeti kimliğini akışın ayarlarından Katkıda Bulunan olarak eklemeniz gerekir. Ayrıntılar için bkz. Akışa kullanıcı/grup izinleri ekleme.

Dış akışa yayımlamak için önce bu akışı işaret etmek için bir hizmet bağlantısı oluşturmanız gerekir. Ayrıntılar için bkz. Hizmet bağlantısını yönetme.

Paket sürümü oluşturma

Universal Packages, semantik sürüm özelliklerine göre tanımlanır ve adları ve sürüm numaralarıyla tanımlanır. Semantik sürüm numaralarının üç sayısal bileşeni vardır: Major, Minor ve Patch: Major.Minor.Patch .

Geriye dönük uyumlu yeni bir özellik yayımlarsanız, ikincil sürümü artırır ve düzeltme eki sürümünü 0 ( olarak ) olarak sıfırlarsınız. Geriye dönük uyumsuz bir değişiklikte ana sürümü artırır ve ikincil ve düzeltme eki sürümlerini 0 ( yerine ) olarak 1.4.17 1.5.0 sıfırlarsınız. 2.6.5 3.0.0 Düzeltme eki sürüm numarası, bir hatayı düzeltmek için ( yerine ) 1.0.0 1.0.1 artırılır.

Yeni Universal Packages, yeni bir paket yayımlarken sizin için sonraki ana, ikincil veya düzeltme eki sürümünü otomatik olarak seçer.

Paketiniz için sürüme eklemeyi etkinleştirmek için versionOption YAML dosyanıza bir giriş ekleyin. Yeni paket sürümünü yayımlama seçenekleri şunlardır: major , minor , veya patch custom .

öğesinin custom seçimi, paket sürümümü el ile belirtmenize olanak sağlar. Diğer seçenekler akışınıza en son paket sürümünü alır ve seçilen sürüm segmentini 1 artırır. Bu nedenle, bir testPackage 1.0.0 varsa ve ana seçeneği belirleyin, yeni paketiniz testPackage 2.0.0 olur. İkincil seçeneği tercih ettiyseniz paket sürümünüz 1.1.0 olur ve düzeltme eki seçeneğini tercih ettiyseniz paket sürümünüz 1.0.1 olur.

Unutmayın; seçeneği tercih ederseniz aşağıdaki gibi custom bir de versionPublish sağlayabilirsiniz.

- task: UniversalPackages@0
  displayName: Universal Publish
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'
    vstsFeedPublish: '<projectName>/<feedName>'
    vstsFeedPackagePublish: '<Package name>'
    versionOption: custom
    versionPublish: '<Package version>'
    packagePublishDescription: '<Package description>'
Bağımsız Değişken Description
publishDirectory Yayımlanacak dosyaların konumu.
vstsFeedPublish Yayımlayacak proje ve akış adı.
vstsFeedPackagePublish Paket adı.
versionOption Sürüm artırma stratejisi seçin. Seçenekler: major , minor , patch , custom
versionPublish Özel paket sürümü
packagePublishDescription Paketin içeriğinin açıklaması.

Evrensel Paket İndirme

Bir Evrensel Paketi, kuruluşta bir akıştan indirmek için, Universal package görevini komut download girişiyle birlikte aşağıdaki gibi kullanın:

steps:
- task: UniversalPackages@0
  displayName: 'Universal download'
  inputs:
    command: download
    vstsFeed: '<projectName>/<feedName>'
    vstsFeedPackage: '<packageName>'
    vstsPackageVersion: '<packageVersion>'
    downloadDirectory: '$(Build.SourcesDirectory)\someFolder'
Bağımsız Değişken Description
vstsFeed İndirilecek Artifacts barındıran bir akış.
vstsFeedPackage İndirilecek paketin adı.
vstsPackageVersion İndirilecek paketin sürümü.
downloadDirectory Paket hedef klasörü. Varsayılan değer: $(System.DefaultWorkingDirectory).

Bir dış kaynaktan Evrensel Paket indirmek için aşağıdaki kod parçacığını kullanın:

steps:
- task: UniversalPackages@0
  displayName: 'Universal download'
  inputs:
    command: download
    feedsToUse: external
    externalFeedCredentials: MSENG2
    feedDownloadExternal: 'fabrikamFeedExternal'
    packageDownloadExternal: 'fabrikam-package'
    versionDownloadExternal: 1.0.0
Bağımsız Değişken Description
feedsToUse Dış kaynaktan external indirirken değerini olarak ayarlayın.
externalFeedCredentials Dış akışı işaret alan hizmet bağlantısının adı. Ayrıntılar için bkz. hizmet bağlantıları.
feedDownloadExternal Dış akışın adı.
packageDownloadExternal İndirilecek paket adı.
versionDownloadExternal İndirilecek paketin sürümü.

Not

Evrensel Paketin en son sürümünü indirmek için indirme komutuna geçiş dizesinde joker karakterler kullanabilirsiniz. Daha Universal Packages için bkz. hızlı başlangıç.

Sonraki Adımlar