Azure Pipelines Universal Packages yayımlayın ve indirin

  • Makale
  • Okumak için 4 dakika

Azure Pipelines

Universal Packages kullanarak, herhangi bir türdeki dosyayı paketedebilir ve takımınızla paylaşabilirsiniz. Evrensel paket görevini kullanarak, 4 TB 'a kadar çeşitli boyutlarda paketleri paketleyebilir, yayımlayabilir ve indirebilirsiniz. Her paket, bir ad ve sürüm numarasıyla benzersiz olarak tanımlanır. paketler, Azure clı veya Azure Pipelines kullanılarak Artifacts akışlarına yayımlanabilir ve bu akışlardan tüketilebilir.

Not

Universal Packages yalnızca Azure DevOps Services kullanılabilir.

Evrensel paket hazırlama

Varsayılan olarak, Universal Packages görevi öğesini $(Build.ArtifactStagingDirectory) Yayımla dizini olarak kullanır. Evrensel paketinizi yayımlamaya hazırlamak için, bu dizine yayımlamak istediğiniz dosyaları yerleştirin. Bu dosyaları Yayımla dizinine kopyalamak için Dosya Kopyala yardımcı programını da kullanabilirsiniz.

Evrensel paket yayımlama

Artifacts akışınıza bir evrensel paket yayımlamak için, aşağıdaki görevi ardışık düzenin yaml dosyasına 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ımlanacak proje ve akış adı.
vstsFeedPackagePublish Paket adı. Küçük harf olmalıdır. Yalnızca harf, sayı ve kısa çizgi kullanın.
packagePublishDescription Paketin içeriğinin açıklaması.

işlem hattınızdan paketleri bir Azure Artifacts akışına yayımlamak için, Project koleksiyonu derleme hizmeti kimliğini akışın ayarlarından katkıda bulunan olarak eklemeniz gerekir. Ayrıntılar için bkz. bir akışa Kullanıcı/Grup Izinleri ekleme .

Bir dış akışa yayımlamak için, önce bu akışa işaret etmek üzere 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 anlam sürümü oluşturma belirtimini izleyin ve adları ve sürüm numaralarıyla tanımlanır. Anlamsal sürüm numaralarının üç sayısal bileşeni, ana, Ikincil ve Yayama vardır: Major.Minor.Patch .

Geriye dönük yeni bir özelliği serbest bırakırsanız, ikincil sürümü artırdınız ve düzeltme eki sürümünü 0 ' a (için) sıfırladınız ve 1.4.171.5.0 geri dönük olarak uyumsuz bir değişiklik yaptığınızda, ana sürümü artırdınız ve ikincil ve düzeltme eki sürümlerini 0 ( 2.6.5 ile) olarak sıfırlayabilirsiniz 3.0.0 . Düzeltme Eki sürüm numarası, bir hatayı düzeltmek (için) durumunda arttırılmalıdır 1.0.01.0.1 .

Universal Packages görev, yeni bir paket yayımladığınızda sizin için bir sonraki büyük, küçük veya düzeltme eki sürümünü otomatik olarak seçer.

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

Seçildiğinde custom , paket sürümünüzü el ile belirtmenize olanak sağlanır. Diğer seçenekler, akışınızdan en son paket sürümünü alacak ve seçilen sürüm segmentini 1 olarak artıracaktır. Bu nedenle, bir testpackage 1.0.0varsa ve ana seçeneği belirlerseniz, yeni paketiniz testpackage 2.0.0olur. İkincil seçeneğini belirlerseniz, paket sürümünüz 1.1.0 olur ve Düzeltme Eki seçeneğini belirlerseniz, paket sürümünüz 1.0.1 olur.

Göz önünde bulundurmanız gereken tek şey, custom seçeneğini belirlerseniz, aşağıdaki gibi bir de belirtmeniz gerekir versionPublish .

- 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ımlanacak 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 bir paket indirin

Kuruluşunuzdaki bir akıştan bir Evrensel paket indirmek için, komut girişi ile birlikte Evrensel paket görevini download aşağıdaki şekilde 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 indirilecek paketi barındıran Artifacts 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 Universal paketini 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 externalBir dış kaynaktan indirme sırasında değeri olarak ayarlayın.
externalFeedCredentials Dış akışa işaret eden 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 bir paketin en son sürümünü indirmek için indirme komutuna geçirdiğiniz dizede joker karakterler kullanabilirsiniz. Daha fazla bilgi için bkz. Universal Packages hızlı başlangıç .

Sonraki Adımlar