UniversalPackages@0 - Evrensel paketler v0 görevi

Evrensel Paketleri indirmek veya paketlemek ve yayımlamak için bu görevi kullanın.

Söz dizimi

# Universal packages v0
# Download or publish Universal Packages.
- task: UniversalPackages@0
  inputs:
    command: 'download' # 'download' | 'publish'. Required. Command. Default: download.
    downloadDirectory: '$(System.DefaultWorkingDirectory)' # string. Required when command = download. Destination directory. Default: $(System.DefaultWorkingDirectory).
    #publishDirectory: '$(Build.ArtifactStagingDirectory)' # string. Required when command = publish. Path to file(s) to publish. Default: $(Build.ArtifactStagingDirectory).
  # Feed & package details
    feedsToUse: 'internal' # 'internal' | 'external'. Alias: internalOrExternalDownload. Required when command = download. Feed location. Default: internal.
    #externalFeedCredentials: # string. Alias: externalEndpoint. Optional. Use when internalOrExternalDownload = external && command = download. organization/collection connection. 
    #vstsFeed: # string. Alias: feedListDownload. Required when internalOrExternalDownload = internal && command = download. Feed. 
    #vstsFeedPackage: # string. Alias: packageListDownload. Required when internalOrExternalDownload = internal && command = download. Package name. 
    #vstsPackageVersion: # string. Alias: versionListDownload. Required when internalOrExternalDownload = internal && command = download. Version. 
    #feedDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Feed (or Project/Feed if the feed was created in a project). 
    #packageDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Package name. 
    #versionDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Version. 
  # Feed & package details
    #feedsToUsePublish: 'internal' # 'internal' | 'external'. Alias: internalOrExternalPublish. Required when command = publish. Feed location. Default: internal.
    #publishFeedCredentials: # string. Alias: externalEndpoints. Required when internalOrExternalPublish = external && command = publish. organization/collection connection. 
    #vstsFeedPublish: # string. Alias: feedListPublish. Required when internalOrExternalPublish = internal && command = publish. Destination Feed. 
    #vstsFeedPackagePublish: # string. Alias: packageListPublish. Required when internalOrExternalPublish = internal && command = publish. Package name. 
    #feedPublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Feed (or Project/Feed if the feed was created in a project). 
    #packagePublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Package name. 
    #versionOption: 'patch' # 'major' | 'minor' | 'patch' | 'custom'. Alias: versionPublishSelector. Required when command = publish. Version. Default: patch.
    #versionPublish: # string. Required when versionPublishSelector = custom && command = publish. Custom version. 
    #packagePublishDescription: # string. Optional. Use when command = publish. Description. 
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = publish && internalOrExternalPublish = internal. Publish pipeline metadata. Default: true.
    #verbosity: 'None' # 'None' | 'Trace' | 'Debug' | 'Information' | 'Warning' | 'Error' | 'Critical'. Verbosity. Default: None.
  # Output
    #publishedPackageVar: # string. Optional. Use when command = publish. Package Output Variable.

Girişler

command - Komut
string. Gereklidir. İzin verilen değerler: download, publish. Varsayılan değer: download.

Çalıştırılacak NuGet komutunu belirtir.

downloadDirectory - Hedef dizin
string. olduğunda command = downloadgereklidir. Varsayılan değer: $(System.DefaultWorkingDirectory).

Görevin paketin içeriğini indirdiği klasör yolunu belirtir.

feedsToUse - Akış konumu
Giriş diğer adı: internalOrExternalDownload. string. olduğunda command = downloadgereklidir. İzin verilen değerler: internal (Bu kuruluş/koleksiyon), external (Başka bir kuruluş/koleksiyon). Varsayılan değer: internal.

Bu koleksiyondan veya Azure Artifacts'teki başka bir koleksiyondan bir akışı belirtir.

externalFeedCredentials - kuruluş/koleksiyon bağlantısı
Giriş diğer adı: externalEndpoint. string. İsteğe bağlı. when internalOrExternalDownload = external && command = downloadkullanın.

Seçili NuGet.configiçinde bulunan dış kayıt defterleri için kullanılacak kimlik bilgilerini belirtir. Bu kuruluş veya koleksiyondaki akışlar için bunu boş bırakın; derlemenin kimlik bilgileri otomatik olarak kullanılır.

vstsFeed - Besleme
Giriş diğer adı: feedListDownload. string. olduğunda internalOrExternalDownload = internal && command = downloadgereklidir.

Seçili akışı içerir. Burada bir akış seçmek için Azure Artifacts'in yüklü ve lisanslı olması gerekir. Kuruluş kapsamındaki bir akışın FeedName değerini ve proje kapsamlı bir akış için projectName/FeedName veya ProjectID/FeedID değerini belirtir.

vstsFeedPackage - Paket adı
Giriş diğer adı: packageListDownload. string. olduğunda internalOrExternalDownload = internal && command = downloadgereklidir.

İndirilmesi gereken görevin paketinin adını belirtir.

vstsPackageVersion - Sürüm
Giriş diğer adı: versionListDownload. string. olduğunda internalOrExternalDownload = internal && command = downloadgereklidir.

Paket sürümünü belirtir veya indirmek için sürümü içeren bir değişken kullanır. Bu giriş, en yüksek sürümü elde etmek için gibi *bir joker karakter ifadesi de olabilir. Örnekler: 1.* Ana sürüm 1 ile en yüksek sürümü alır ve ana sürüm 1 ve 1.2.* ikincil sürüm 2 ile en yüksek düzeltme eki sürümünü alır.

feedDownloadExternal - Akış (veya akış bir projede oluşturulduysa Proje/Akış)
string. olduğunda internalOrExternalDownload = external && command = downloadgereklidir.

Başka bir kuruluştaki/koleksiyondaki bir akışı belirtir.

Proje kapsamlı akışlar için değer olmalıdır Project/Feed; burada Project projenin adı veya kimliği ve Feed akışın adı/kimliğidir. Kuruluş kapsamındaki akışlar için değer yalnızca akış adı olmalıdır.

packageDownloadExternal - Paket adı
string. olduğunda internalOrExternalDownload = external && command = downloadgereklidir.

İndirilmesi gereken paket adını belirtir.

versionDownloadExternal - Sürüm
string. olduğunda internalOrExternalDownload = external && command = downloadgereklidir.

Paket sürümünü belirtir veya indirmek için sürümü içeren bir değişken kullanır. Bu giriş, en yüksek sürümü elde etmek için gibi *bir joker karakter ifadesi de olabilir. Örnekler: 1.* Ana sürüm 1 ile en yüksek sürümü alır ve ana sürüm 1 ve 1.2.* ikincil sürüm 2 ile en yüksek düzeltme eki sürümünü alır. Joker karakter desenleri yayın öncesi paketlerde desteklenmez.

publishDirectory - Yayımlayacak dosya yolu
string. olduğunda command = publishgereklidir. Varsayılan değer: $(Build.ArtifactStagingDirectory).

Yayımlanacak dosyaların listesinin yolunu belirtir.

feedsToUsePublish - Akış konumu
Giriş diğer adı: internalOrExternalPublish. string. olduğunda command = publishgereklidir. İzin verilen değerler: internal (Bu kuruluş/koleksiyon), external (Başka bir kuruluş/koleksiyon). Varsayılan değer: internal.

Bu koleksiyondan veya Azure Artifacts'teki başka bir koleksiyondan bir akışı belirtir.

publishFeedCredentials - kuruluş/koleksiyon bağlantısı
Giriş diğer adı: externalEndpoints. string. olduğunda internalOrExternalPublish = external && command = publishgereklidir.

Dış akışlar için kullanılacak kimlik bilgilerini belirtir.

vstsFeedPublish - Hedef Akış
Giriş diğer adı: feedListPublish. string. olduğunda internalOrExternalPublish = internal && command = publishgereklidir.

Projeyi ve yayımlayacak akışın adını/GUID'sini belirtir.

publishPackageMetadata - İşlem hattı meta verilerini yayımlama
boolean. İsteğe bağlı. olduğunda command = publish && internalOrExternalPublish = internalkullanın. Varsayılan değer: true.

Bu derleme/yayın işlem hattının meta verilerini (çalıştırma # ve kaynak kodu bilgileri gibi) paketle ilişkilendirir.

vstsFeedPackagePublish - Paket adı
Giriş diğer adı: packageListPublish. string. olduğunda internalOrExternalPublish = internal && command = publishgereklidir.

Daha önce bu paketin bir sürümünü yayımlamadıysanız yayımlanacak paket kimliğini belirtir veya yeni bir paket kimliği oluşturur. Paket adları küçük harf olmalıdır ve yalnızca harf, sayı ve kısa çizgi (-) kullanabilir.

feedPublishExternal - Akış (veya akış bir projede oluşturulduysa Proje/Akış)
string. olduğunda internalOrExternalPublish = external && command = publishgereklidir.

Yayımlayacak dış akış adını belirtir.

Akış bir projede oluşturulduysa, değer Project/Feedolmalıdır; burada Project projenin adı veya kimliği ve Feed akışın adıdır. Akış bir projede oluşturulmadıysa, değer yalnızca akış adı olmalıdır.

packagePublishExternal - Paket adı
string. olduğunda internalOrExternalPublish = external && command = publishgereklidir.

Dış akışta yayımlarken paket adını belirtir.

versionOption - Sürüm
Giriş diğer adı: versionPublishSelector. string. olduğunda command = publishgereklidir. İzin verilen değerler: major (Sonraki birincil), minor (Sonraki ikincil), patch (Sonraki düzeltme eki), custom. Varsayılan değer: patch.

Sürüm artırma stratejisini belirtir. custom Paket sürümünüzü el ile girilebilecek değer. Yeni paketler için, belirtirseniz ilk sürüm 1.0.0, belirtirseniz major0.1.0 minorveya belirtirseniz patch0.0.1 olur. Daha fazla bilgi için Anlamsal Sürüm oluşturma belirtimlerine bakın.

versionPublish - Özel sürüm
string. olduğunda versionPublishSelector = custom && command = publishgereklidir.

Paket için özel bir sürüm şeması belirtir.

packagePublishDescription - Açıklama
string. İsteğe bağlı. olduğunda command = publishkullanın.

Paket içeriğinin açıklamasını ve/veya paketin bu sürümünde yapılan değişiklikleri belirtir.

verbosity - Ayrıntı
string. İzin verilen değerler: None, Trace, Debug, Information, , Warning, Error, Critical. Varsayılan değer: None.

Çıktıda görüntülenen ayrıntı miktarını belirtir.

publishedPackageVar - Paket Çıkış Değişkeni
string. İsteğe bağlı. olduğunda command = publishkullanın.

Yayımlanan paket adını ve sürümünü içerecek değişken için bir ad belirtir.

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

Evrensel Paketleri indirmek veya paketlemek ve yayımlamak için bu görevi kullanın.

İşlem Hattımın farklı bir projedeki akışa erişmesi gerekiyor

İşlem hattı akışı barındıran projeden farklı bir projede çalışıyorsa, derleme hizmetine okuma/yazma erişimi vermek için diğer projeyi ayarlamanız gerekir. Diğer ayrıntılar için bkz. Azure Pipelines'da paket izinleri .

Örnekler

Evrensel Paket görevini kullanmaya başlamanın en basit yolu, YAML'yi oluşturmak için pipelines görev düzenleyicisini kullanmaktır. Daha sonra oluşturulan kodu projenizin azure-pipelines.yml dosyasına kopyalayabilirsiniz. Bu örnekte örnek, GatsbyJS aşamalı web uygulaması (PWA) oluşturan bir işlem hattı kullanarak YAML'nin nasıl hızlı bir şekilde oluşturulacağı gösterilmektedir.

Evrensel Paketler, bir web uygulamasını hem kapsüllemenin hem de sürüm oluşturmanın kullanışlı bir yoludur. Bir web uygulamasını Evrensel Pakette paketlemek, sitenizin belirli bir sürümüne hızlı geri alma sağlar ve siteyi dağıtım işlem hattında oluşturma gereksinimini ortadan kaldırır.

Bu örnek işlem hattında, projenizdeki bir akıştan bir aracın nasıl getirilmeye devam olduğu gösterilmektedir. Evrensel Paket görevi aracı indirmek, derleme çalıştırmak ve yeniden Evrensel Paket görevini kullanarak derlenmiş GatsbyJS PWA'nın tamamını sürümlenmiş Evrensel Paket olarak akışa yayımlar.

Evrensel Paket göreviyle paket indirme

Örnek projedeki ikinci görev, aynı kuruluştaki farklı bir proje içinde yer alan bir akıştan imagemagick adlı bir aracı getirmek için Evrensel Paket görevini kullanır. Imagemagick aracı, görüntüleri yeniden boyutlandırmak için sonraki derleme adımında gereklidir.

1. Artı simgesine tıklayarak, arama kutusuna "evrensel" yazarak ve görevi işlem hattınıza eklemek için Ekle düğmesine tıklayarak Evrensel Paket görevini ekleyin.

   

2. Yeni eklenen Evrensel Paket görevine ve komutunaDownloadtıklayın.

3. Araç indirme için kullanılacak Hedef dizini seçin.

4. Aracı içeren bir kaynak Akışı seçin, Paket adını ayarlayın ve kaynak Akıştan imagemagick aracının Sürümü'ne tıklayın.

   

5. Alanları tamamladıktan sonra, oluşturulan YAML'yi görmek için YAML'yi Görüntüle'ye tıklayın.

   

6. Evrensel Paket görev oluşturucusu, varsayılan olmayan değerler içeren basitleştirilmiş YAML oluşturur. Oluşturulan YAML'yi projenizin azure-pipelines.ymlgit deposunun kökündeki dosyanıza kopyalayın.

   # Download Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal download'
     inputs:
       downloadDirectory: Application
       vstsFeed: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000001'
       vstsFeedPackage: imagemagick
       vstsPackageVersion: 1.0.0
   

Evrensel Paket göreviyle paket yayımlama

Bu örnek işlem hattındaki son adım, üretime hazır Gatsby PWA'yı Run gatsby build sürümlü Evrensel Paket olarak bir akışa yüklemek için Evrensel Paket görevini kullanır. Bir akışa girdikten sonra, barındırma sağlayıcısına dağıtılabilir ve ile gatsby servebaşlatılabilir tam sitenizin kalıcı bir kopyasına sahip olursunuz.

1. Artı simgesine tıklayarak, arama kutusuna "evrensel" yazarak ve görevi işlem hattınıza eklemek için Ekle düğmesine tıklayarak işlem hattının sonuna başka bir Evrensel Paket görevi ekleyin. Bu görev, adım tarafından Run gatsby build üretilen üretime hazır varlıkların tümünü toplar, sürümü oluşturulan bir Evrensel Paket oluşturur ve paketi bir akışta yayımlar.

   

2. Command değerini olarak Publishayarlayın.

3. GatsbyJS projenizin package.jsonöğesini içeren dizinde yayımlamak için Dosya yolu olarak ayarlayın.

4. Hedef akışı, paket adını seçin ve sürüm oluşturma stratejinizi ayarlayın.

   

5. Gerekli alanları tamamladıktan sonra YAML Görüntüle'ye tıklayın.

6. Sonuçta elde edilen YAML'yi daha önce olduğu gibi dosyanıza azure-pipelines.yml kopyalayın. Bu örnek proje için YAML aşağıda görüntülenir.

   # Publish Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal publish'
     inputs:
       command: publish
       publishDirectory: Application
       vstsFeedPublish: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000002' # You can also use '<projectName>/<feedName>' instead of the GUIDs
       vstsFeedPackagePublish: mygatsbysite
       packagePublishDescription: 'A test package'
   

Bu örnekte, Evrensel Paket görevi için YAML'yi hızlı bir şekilde oluşturmak üzere İşlem Hatları görev oluşturucusunun nasıl kullanılacağı gösterilmiştir ve bu görev daha sonra dosyanıza azure-pipelines.yml yerleştirilebilir. Evrensel Paket görev oluşturucusu, Evrensel Paket görevinin bağımsız değişkenleriyle oluşturulabilen tüm gelişmiş yapılandırmaları destekler.

Not

Bir paketi doğrudan görünüme yayımlama, Azure Artifacts'te desteklenmez. Paketi önce akışınızda yayımlamanız, ardından bir görünüme yükseltmeniz gerekir.

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.144.0 veya üzeri
Görev kategorisi	Paket