Publikování a stažení univerzálních balíčků pomocí Azure Pipelines

Azure DevOps Services

Univerzální balíčky umožňují zabalit libovolný počet souborů libovolného typu a sdílet je s týmem. Pomocí úlohy Univerzální balíček ve službě Azure Pipelines můžete balíčky sbalit, publikovat a stahovat různé velikosti až do 4 TB. Každý balíček je jednoznačně identifikován názvem a číslem verze. Pomocí Azure CLI nebo Azure Pipelines můžete publikovat a využívat balíčky z informačních kanálů Artifacts.

Poznámka

Univerzální balíčky jsou dostupné jenom v Azure DevOps Services.

Kopírování souborů

Úloha Univerzální balíčky ve službě Azure Pipelines je nastavená tak, aby jako výchozí adresář publikování používala $(Build.ArtifactStagingDirectory). Chcete-li připravit univerzální balíček pro publikování, přesuňte soubory, které chcete publikovat do daného adresáře. K zkopírování těchto souborů do adresáře publikování můžete použít také úlohu nástroje Kopírovat soubory.

Publikování univerzálního balíčku

Pro publikování Univerzálního balíčku do vašeho informačního kanálu služby Azure Artifacts přidejte do YAML souboru vašeho kanálu následující úlohu.

- task: UniversalPackages@0
  displayName: Publish a Universal Package
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'
    vstsFeedPublish: '<projectName>/<feedName>'
    vstsFeedPackagePublish: '<Package name>'
    packagePublishDescription: '<Package description>'

Argument	Popis
publishDirectory	Umístění souborů, které chcete publikovat.
vstsFeedPublish	Název projektu a informačního kanálu, do které se má publikovat. Pokud pracujete s informačním kanálem v rámci organizace, zadejte pouze název informačního kanálu.
vstsFeedPackagePublish	Název balíčku. Musí obsahovat malá písmena. Používejte jenom písmena, číslice a pomlčky.
popis publikace balíčku	Popis obsahu balíčku

Pokud chcete publikovat balíčky do kanálu Azure Artifacts ze svého kanálu, identita vašeho kanálu musí mít roli Feed Publisher (Přispěvatel) přiřazenou k tomuto kanálu. Další informace naleznete v tématu oprávnění pro Pipelines.

Abyste mohli publikovat do externího kanálu, musíte nejprve vytvořit připojení ke službě pro ověření se vůči vašemu kanálu. Další informace naleznete v tématu Správa připojení služby.

Pokud chcete publikovat univerzální balíček, přidejte do pipeliny úlohu Universal Package a zadejte požadované informace následovně:

• Příkaz: Publikovat

• Cesta k souborům k publikování: Cesta k seznamu souborů, které se mají publikovat. Výchozí hodnota: $(Build.ArtifactStagingDirectory).

• Umístění kanálu : Publikovat do kanálu Azure Artifacts ve vaší současné organizaci nebo jiné organizaci.

• cílový informační kanál: Vyberte informační kanál, do kterého chcete publikovat.

• Název balíčku: Vyberte existující balíček (chcete-li publikovat novou verzi balíčku), nebo zadejte nový název balíčku (chcete-li publikovat první verzi nového balíčku).

  

Pokud chcete publikovat balíčky do kanálu Azure Artifacts z vašeho kanálu, nastavte identitu, ve které se sestavení spouští, jako vydavatele kanálu (Přispěvatel). Pokud je kanál buildu nakonfigurovaný tak, aby se spustil pomocí oboru kolekce projektů, přidejte službu sestavení kolekce projektů identitu jako vydavatele informačního kanálu (přispěvatel).

Pokud je sestavovací kanál nakonfigurovaný tak, aby se spouštěl pomocí rozsahu projektu, měla by mít identita služby Sestavení projektu přispěvatelský přístup k zdroji. Rozsah, ve kterém jsou vaše buildy spuštěné, můžete zkontrolovat tak, že otevřete editor kanálu a zkontrolujete kartu Možnosti. Další informace o oprávněních informačních kanálů najdete v tématu správa balíčků s oprávněními informačního kanálu.

Pokud chcete publikovat do externího informačního kanálu, musíte nejprve vytvořit připojení služby, které bude odkazovat na tento informační kanál. Další informace naleznete v tématu Správa připojení služby.

Správa verzí balíčků

Univerzální balíčky se řídí specifikací sémantické správy verzí a mohou být identifikovány jejich názvy a čísly verzí. Sémantická čísla verzí se skládají ze tří číselných složek: major, minor a patch ve formátu: Major.Minor.Patch.

Číslo podverze se zvýší při přidání nových funkcí, které jsou zpětně kompatibilní s předchozími verzemi, v tomto případě zvýšíte podverzi a resetujete verzi opravy na 0 (1.4.17 na 1.5.0). Číslo hlavní verze se zvýší, pokud dojde k významným změnám, které by mohly narušit kompatibilitu s předchozími verzemi. V tomto případě zvýšíte hlavní verzi a resetujete podverzi a opravy na 0 (2.6.5 na 3.0.0). Číslo verze opravy by se mělo zvýšit, pokud jsou provedeny pouze opravy chyb nebo jiné malé změny, které nemají vliv na kompatibilitu s předchozími verzemi (1.0.0 na 1.0.1).

Při publikování nového balíčku úloha Univerzálních balíčků za vás automaticky vybere další hlavní, vedlejší nebo opravnou verzi.

Pokud chcete povolit správu verzí balíčku, přidejte do souboru YAML versionOption vstup. Možnosti publikování nové verze balíčku jsou: major, minor, patchnebo custom.

Výběr custom umožňuje ruční zadání verze balíčku. Ostatní možnosti z vašeho repozitáře získají nejnovější verzi balíčku a zvýší určený segment verze o 1. Pokud tedy máte testPackage 1.0.0a zvolíte možnost hlavní, váš nový balíček bude testPackage 2.0.0. Pokud vyberete možnost podverze, bude verze balíčku 1.1.0a pokud vyberete možnost oprava, bude verze balíčku 1.0.1.

Pokud zvolíte možnost custom, musíte také zadat versionPublish hodnotu následujícím způsobem:

- task: UniversalPackages@0
  displayName: Publish a Universal Package
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'
    vstsFeedPublish: '<projectName>/<feedName>'
    vstsFeedPackagePublish: '<Package name>'
    versionOption: custom
    versionPublish: '<Package version>'
    packagePublishDescription: '<Package description>'

Argument	Popis
publikovatAdresář	Umístění souborů, které chcete publikovat.
vstsFeedPublish	Název projektu a informačního kanálu, do které se má publikovat. Pokud pracujete s informačním kanálem na úrovni organizace, zadejte pouze název informačního kanálu.
vstsFeedPackagePublish	Název balíčku. Musí obsahovat malá písmena. Používejte jenom písmena, číslice a pomlčky.
versionOption	Vyberte strategii správy verzí. Možnosti: major, minor, patch, custom.
verzeZveřejnit	Vlastní verze balíčku.
packagePublishDescription	Popis obsahu balíčku

Ve formuláři úlohy Univerzální balíčky vyberte strategii správy verzí nebo vyberte Vlastní a zadejte verzi balíčku ručně.

Stažení univerzálního balíčku

YAML

Pokud chcete stáhnout univerzální balíček z informačního kanálu ve vaší organizaci, použijte úlohu Univerzální balíček s příkazem download následujícím způsobem:

steps:
- task: UniversalPackages@0
  displayName: Download a Universal Package
  inputs:
    command: download
    vstsFeed: '<projectName>/<feedName>'
    vstsFeedPackage: '<packageName>'
    vstsPackageVersion: '<packageVersion>'
    downloadDirectory: '$(Build.SourcesDirectory)\someFolder'

Argument	Popis
vstsFeed	Informační kanál Artifacts hostující balíček, který se má stáhnout.
vstsFeedPackage	Název balíčku, který se má stáhnout.
vstsPackageVersion	Verze balíčku, který se má stáhnout.
downloadDirectory	Cílová složka balíčku. Výchozí hodnota: $(System.DefaultWorkingDirectory).

Pokud chcete stáhnout univerzální balíček z externího zdroje, použijte následující fragment kódu:

steps:
- task: UniversalPackages@0
  displayName: Download a Universal Package
  inputs:
    command: download
    feedsToUse: external
    externalFeedCredentials: 'MSENG2'
    feedDownloadExternal: 'fabrikamFeedExternal'
    packageDownloadExternal: 'fabrikam-package'
    versionDownloadExternal: 1.0.0

Argument	Popis
kanály ke použití	Nastavte hodnotu na external při stahování z externího zdroje.
externalFeedCredentials	Název připojení služby k externímu informačnímu kanálu. Další informace najdete v tématu správa připojení služeb.
feedDownloadExternal	Název externího informačního kanálu
packageDownloadExternal	Název balíčku, který chcete stáhnout.
staženíExterníVerze	Verze balíčku, který chcete stáhnout.

Pokud chcete stáhnout univerzální balíček, přidejte do kanálu úlohu Univerzální balíček a vyplňte požadovaná pole následujícím způsobem:

• Příkaz: Stáhnout
• cílový adresář: Cesta ke složce, kam se balíčky stáhnou. Výchozí hodnota: $(System.DefaultWorkingDirectory).
• Umístění kanálu: Stáhnout univerzální balíček z kanálu ve vaší organizaci nebo v jiné organizaci.
• Informační kanál: Informační kanál, ze kterého chcete stáhnout.
• Název balíčku: Název balíčku, který se má stáhnout.
• verze: verzi balíčku, který chcete stáhnout.

Spropitné

Pomocí zástupných znaků můžete stáhnout nejnovější verzi univerzálního balíčku. Pro více informací viz Stáhněte nejnovější verzi.

Související články

• Upstreamové zdroje pro Universal Packages
• Hledání balíčků v upstreamových zdrojích
• oprávnění informačního kanálu