UniversalPackages@0 – úloha Universal packages v0

Pomocí této úlohy můžete stáhnout nebo zabalit a publikovat univerzální balíčky.

Syntax

# 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.

Vstupy

command - Příkaz
string. Povinná hodnota. Povolené hodnoty: download, publish. Výchozí hodnota: download.

Určuje příkaz NuGet, který se má spustit.

downloadDirectory - Cílový adresář
string. Vyžaduje se, když command = download. Výchozí hodnota: $(System.DefaultWorkingDirectory).

Určuje cestu ke složce, kam úkol stáhne obsah balíčku.

feedsToUse - Umístění informačního kanálu
Vstupní alias: internalOrExternalDownload. string. Vyžaduje se, když command = download. Povolené hodnoty: internal (Tato organizace/kolekce), external (Jiná organizace/kolekce). Výchozí hodnota: internal.

Určuje informační kanál z této kolekce nebo jiné kolekce v Azure Artifacts.

externalFeedCredentials - připojení k organizaci nebo kolekci
Vstupní alias: externalEndpoint. string. Nepovinný parametr. Použijte, když internalOrExternalDownload = external && command = download.

Určuje přihlašovací údaje, které se mají použít pro externí registry umístěné ve vybraném NuGet.configobjektu . U informačních kanálů v této organizaci nebo kolekci ponechte toto prázdné. přihlašovací údaje sestavení se použijí automaticky.

vstsFeed - Krmivo
Vstupní alias: feedListDownload. string. Vyžaduje se, když internalOrExternalDownload = internal && command = download.

Zahrnuje vybraný informační kanál. Abyste mohli vybrat informační kanál, musíte mít nainstalovanou a licencovanou službu Azure Artifacts. Určuje FeedName pro informační kanál v rozsahu organizace a projectName/FeedName nebo ProjectID/FeedID pro kanál s oborem projektu.

vstsFeedPackage - Název balíčku
Vstupní alias: packageListDownload. string. Vyžaduje se, když internalOrExternalDownload = internal && command = download.

Určuje název balíčku pro úlohu, která se má stáhnout.

vstsPackageVersion - Verze
Vstupní alias: versionListDownload. string. Vyžaduje se, když internalOrExternalDownload = internal && command = download.

Určuje verzi balíčku nebo používá proměnnou obsahující verzi ke stažení. Tato položka může být také výraz se zástupným znakem, například *, pro získání nejvyšší verze. Příklady: 1.* Získá nejvyšší verzi s hlavní verzí 1 a 1.2.* nejvyšší verzi opravy s hlavní verzí 1 a podverzi 2.

feedDownloadExternal - Informační kanál (nebo projekt/informační kanál, pokud byl informační kanál vytvořen v projektu)
string. Vyžaduje se, když internalOrExternalDownload = external && command = download.

Určuje informační kanál v jiné organizaci nebo kolekci.

U informačních kanálů s oborem projektu by hodnota měla být Project/Feed, kde Project je název nebo ID projektu a Feed název/ID informačního kanálu. U informačních kanálů s rozsahem organizace by hodnota měla být pouze název informačního kanálu.

packageDownloadExternal - Název balíčku
string. Vyžaduje se, když internalOrExternalDownload = external && command = download.

Určuje název balíčku ke stažení.

versionDownloadExternal - Verze
string. Vyžaduje se, když internalOrExternalDownload = external && command = download.

Určuje verzi balíčku nebo používá proměnnou obsahující verzi ke stažení. Tato položka může být také výraz se zástupným znakem, například *, pro získání nejvyšší verze. Příklady: 1.* Získá nejvyšší verzi s hlavní verzí 1 a 1.2.* nejvyšší verzi opravy s hlavní verzí 1 a podverzi 2. Vzory zástupných znaků nejsou podporovány v předběžných verzích balíčků.

publishDirectory - Cesta k souborům k publikování
string. Vyžaduje se, když command = publish. Výchozí hodnota: $(Build.ArtifactStagingDirectory).

Určuje cestu k seznamu souborů, které mají být publikovány.

feedsToUsePublish - Umístění informačního kanálu
Vstupní alias: internalOrExternalPublish. string. Vyžaduje se, když command = publish. Povolené hodnoty: internal (Tato organizace/kolekce), external (Jiná organizace/kolekce). Výchozí hodnota: internal.

Určuje informační kanál z této kolekce nebo jiné kolekce v Azure Artifacts.

publishFeedCredentials - připojení k organizaci nebo kolekci
Vstupní alias: externalEndpoints. string. Vyžaduje se, když internalOrExternalPublish = external && command = publish.

Určuje přihlašovací údaje, které se mají použít pro externí informační kanály.

vstsFeedPublish - Cílový informační kanál
Vstupní alias: feedListPublish. string. Vyžaduje se, když internalOrExternalPublish = internal && command = publish.

Určuje projekt a název nebo identifikátor GUID informačního kanálu, do které se má publikovat.

publishPackageMetadata - Publikování metadat kanálu
boolean. Nepovinný parametr. Použijte, když command = publish && internalOrExternalPublish = internal. Výchozí hodnota: true.

Přidruží metadata tohoto kanálu buildu nebo verze (například run # a informace o zdrojovém kódu) k balíčku.

vstsFeedPackagePublish - Název balíčku
Alias vstupu: packageListPublish. string. Vyžaduje se, když internalOrExternalPublish = internal && command = publish.

Určuje ID balíčku, který se má publikovat, nebo vytvoří nové ID balíčku, pokud jste ještě nikdy nepublikovali verzi tohoto balíčku. Názvy balíčků musí být malé a smí používat jenom písmena, číslice a pomlčky (-).

feedPublishExternal - Informační kanál (nebo projekt/informační kanál, pokud byl informační kanál vytvořen v projektu)
string. Vyžaduje se, když internalOrExternalPublish = external && command = publish.

Určuje název externího informačního kanálu, do které se má publikovat.

Pokud byl informační kanál vytvořen v projektu, hodnota by měla být Project/Feed, kde Project je název nebo ID projektu a Feed je název informačního kanálu. Pokud informační kanál nebyl vytvořen v projektu, hodnota by měla být pouze název informačního kanálu.

packagePublishExternal - Název balíčku
string. Vyžaduje se, když internalOrExternalPublish = external && command = publish.

Určuje název balíčku při publikování do externího kanálu.

versionOption - Verze
Alias vstupu: versionPublishSelector. string. Vyžaduje se, když command = publish. Povolené hodnoty: major (Next major), minor (Next minor), patch (Next patch), custom. Výchozí hodnota: patch.

Určuje strategii zvýšení verze. Hodnota custom pro ruční zadání verze balíčku. Pro nové balíčky bude první verze 1.0.0, pokud zadáte major, 0.1.0 pokud zadáte minor, nebo 0.0.1, pokud zadáte patch. Další informace najdete ve specifikaci sémantické správy verzí .

versionPublish - Vlastní verze
string. Vyžaduje se, když versionPublishSelector = custom && command = publish.

Určuje vlastní schéma verze pro balíček.

packagePublishDescription - Popis
string. Nepovinný parametr. Použijte, když command = publish.

Určuje popis obsahu balíčku nebo změny provedené v této verzi balíčku.

verbosity - Podrobnost
string. Povolené hodnoty: None, Trace, , InformationDebug, , Warning, Error, . Critical Výchozí hodnota: None.

Určuje množství podrobností zobrazených ve výstupu.

publishedPackageVar - Výstupní proměnná balíčku
string. Nepovinný parametr. Použijte, když command = publish.

Určuje název proměnné, která bude obsahovat název a verzi publikovaného balíčku.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Pomocí této úlohy můžete stáhnout nebo zabalit a publikovat univerzální balíčky.

Kanál potřebuje přístup ke kanálu v jiném projektu

Pokud kanál běží v jiném projektu než v projektu, který je hostitelem informačního kanálu, musíte nastavit druhý projekt tak, aby službě sestavení udělil přístup pro čtení a zápis. Další podrobnosti najdete v tématu Oprávnění balíčků ve službě Azure Pipelines .

Příklady

Nejjednodušším způsobem, jak začít s úlohou Univerzální balíček, je vygenerovat YAML pomocí editoru úloh Pipelines. Pak můžete vygenerovaný kód zkopírovat do souboru projektu azure-pipelines.yml . V tomto příkladu ukázka ukazuje, jak rychle vygenerovat YAML pomocí kanálu, který sestaví progresivní webovou aplikaci GatsbyJS (PWA).

Univerzální balíčky představují užitečný způsob zapouzdření a verze webové aplikace. Zabalení webové aplikace do univerzálního balíčku umožňuje rychlé vrácení zpět ke konkrétní verzi webu a eliminuje nutnost vytvořit web v kanálu nasazení.

Tento ukázkový kanál ukazuje, jak načíst nástroj z informačního kanálu v rámci projektu. Úloha Univerzální balíček slouží ke stažení nástroje, spuštění sestavení a znovu používá úlohu Universal Package k publikování celého zkompilovaného souboru GatsbyJS PWA do informačního kanálu jako univerzálního balíčku s verzí.

Stažení balíčku s úlohou Universal Package

Druhý úkol v ukázkovém projektu používá úlohu Univerzální balíček k načtení nástroje imagemagick z informačního kanálu, který je v rámci jiného projektu ve stejné organizaci. Nástroj imagemagick vyžaduje následující krok sestavení ke změně velikosti obrázků.

1. Přidejte úlohu Univerzální balíček tak, že kliknete na ikonu plus, do vyhledávacího pole zadáte "univerzální" a kliknutím na tlačítko Přidat přidáte úlohu do kanálu.

   

2. Klikněte na nově přidanou úlohu Universal Package a na příkaz do Download.

3. Zvolte cílový adresář , který chcete použít ke stažení nástroje.

4. Vyberte zdrojový kanál, který obsahuje nástroj, nastavte název balíčku a ze zdrojového kanálu zvolte Verze nástroje imagemagick.

   

5. Po dokončení polí klikněte na Zobrazit YAML a zobrazte vygenerovaný YAML.

   

6. Tvůrce úloh univerzálního balíčku generuje zjednodušený kód YAML, který obsahuje jiné než výchozí hodnoty. Zkopírujte vygenerovaný YAML do souboru azure-pipelines.yml v kořenovém adresáři úložiště Git vašeho projektu.

   # 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
   

Publikování balíčku pomocí úlohy Univerzální balíček

Poslední krok v tomto ukázkovém kanálu používá úlohu Univerzální balíček k nahrání Gatsby PWA připraveného pro produkční prostředí vytvořeného v tomto Run gatsby build kroku do informačního kanálu jako univerzálního balíčku s verzí. Jakmile budete v informačním kanálu, budete mít trvalou kopii celého webu, kterou můžete nasadit u poskytovatele hostingu a začít s gatsby serve.

1. Přidejte další úlohu Univerzálního balíčku na konec kanálu tak, že kliknete na ikonu plus, do vyhledávacího pole zadáte "universal" a kliknutím na tlačítko Přidat přidáte úlohu do kanálu. Tato úloha shromáždí všechny prostředky připravené pro produkční prostředí vytvořené v Run gatsby build kroku, vytvoří univerzální balíček s verzí a publikuje balíček do informačního kanálu.

   

2. Nastavte příkaz na Publish.

3. Nastavte cestu k souborům, které se mají publikovat do adresáře obsahujícího package.jsonprojekt GatsbyJS.

4. Zvolte cílový informační kanál, název balíčku a nastavte strategii správy verzí.

   

5. Po dokončení požadovaných polí klikněte na Zobrazit YAML.

6. Zkopírujte výsledný YAML do souboru azure-pipelines.yml jako předtím. Níže se zobrazí YAML pro tento ukázkový projekt.

   # 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'
   

Tento příklad ukázal, jak pomocí tvůrce úloh Pipelines rychle vygenerovat YAML pro úlohu Universal Package, která se pak dá umístit do souboru azure-pipelines.yml . Tvůrce úloh Univerzální balíček podporuje všechny pokročilé konfigurace, které lze vytvořit pomocí argumentů úlohy Universal Package .

Poznámka

Publikování balíčku přímo do zobrazení se v Azure Artifacts nepodporuje. Nejprve musíte balíček publikovat do informačního kanálu a pak ho zvýšit na zobrazení.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build, klasická verze
Běží na	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	2.144.0 nebo vyšší
Kategorie úloh	Balíček