Publikowanie i pobieranie pakietów uniwersalnych za pomocą usługi Azure Pipelines

  • Artykuł

Azure DevOps Services

Pakiety uniwersalne umożliwiają pakowanie dowolnej liczby plików dowolnego typu i udostępnianie ich zespołowi. Za pomocą zadania Pakiet uniwersalny w usłudze Azure Pipelines można pakować, publikować i pobierać pakiety o różnych rozmiarach do 4 TB. Każdy pakiet jest jednoznacznie identyfikowany z nazwą i numerem wersji. Interfejs wiersza polecenia platformy Azure lub usługa Azure Pipelines umożliwia publikowanie i używanie pakietów z kanałów informacyjnych Artifacts.

Uwaga

Pakiety uniwersalne są dostępne tylko w usługach Azure DevOps Services.

Kopiowanie plików

Zadanie Pakiety uniwersalne w usłudze Azure Pipelines ma być używane $(Build.ArtifactStagingDirectory) jako domyślny katalog publikowania. Aby przygotować pakiet uniwersalny do publikowania, przenieś pliki, które chcesz opublikować w tym katalogu. Możesz również użyć zadania narzędzia Kopiuj pliki , aby skopiować te pliki do katalogu publikowania.

Publikowanie pakietu uniwersalnego

Aby opublikować pakiet uniwersalny do źródła danych usługi Azure Artifacts, dodaj następujące zadanie do pliku YAML potoku.

- task: UniversalPackages@0
  displayName: Publish a Universal Package
  inputs:
    command: publish
    publishDirectory: '$(Build.ArtifactStagingDirectory)'
    vstsFeedPublish: '<projectName>/<feedName>'
    vstsFeedPackagePublish: '<Package name>'
    packagePublishDescription: '<Package description>'
Argument opis
publishDirectory Lokalizacja plików, które chcesz opublikować.
vstsFeedPublish Nazwa projektu i kanału informacyjnego do opublikowania. Jeśli pracujesz z kanałem informacyjnym o zakresie organizacji, określ tylko nazwę źródła danych.
vstsFeedPackagePublish Nazwa pakietu. Musi mieć małe litery. Używaj tylko liter, cyfr i kresek.
packagePublishDescription Opis zawartości pakietu.

Aby publikować pakiety w kanale informacyjnym usługi Azure Artifacts z potoku, tożsamość potoku musi mieć rolę Wydawca źródła danych (współautor). Aby uzyskać więcej informacji, zobacz Uprawnienia potoków.

Aby opublikować w zewnętrznym kanale informacyjnym, musisz najpierw utworzyć połączenie usługi w celu uwierzytelnienia się w kanale informacyjnym. Aby uzyskać więcej informacji, zobacz Zarządzanie połączeniem z usługą.

Przechowywanie wersji pakietów

Pakiety uniwersalne są zgodne ze specyfikacją semantycznej wersji i mogą być identyfikowane przez ich nazwy i numery wersji. Semantyczne numery wersji składają się z trzech składników liczbowych, głównych, pomocniczych i poprawek w formacie: Major.Minor.Patch.

Numer wersji pomocniczej jest zwiększany po dodaniu nowych funkcji, które są zgodne z poprzednimi wersjami, w tym przypadku zwiększasz wersję pomocniczą i resetujesz wersję poprawki do 0 (1.4.17 do 1.5.0). Numer wersji głównej jest zwiększany, gdy istnieją istotne zmiany, które mogą przerwać zgodność z poprzednimi wersjami. W takim przypadku zwiększasz wersję główną i resetujesz wersje pomocnicze i poprawkowe do 0 (2.6.5 do 3.0.0). Numer wersji poprawki powinien być zwiększany, gdy wprowadzono tylko poprawki usterek lub inne małe zmiany, które nie mają wpływu na zgodność z poprzednimi wersjami (1.0.0 do 1.0.1).

Podczas publikowania nowego pakietu zadanie Pakiety uniwersalne automatycznie wybierze następną wersję główną, pomocniczą lub poprawkową.

Aby włączyć przechowywanie wersji pakietu, dodaj versionOption dane wejściowe do pliku YAML. Opcje publikowania nowej wersji pakietu to: major, , minorpatchlub custom.

Wybranie custom umożliwia ręczne określenie wersji pakietu. Inne opcje pobierają najnowszą wersję pakietu ze źródła danych i zwiększają wybrany segment wersji o 1. Więc jeśli masz pakiet testPackage 1.0.0 i wybierz opcję główną , nowy pakiet będzie testPackage 2.0.0. Jeśli wybierzesz opcję pomocniczą, wersja pakietu będzie mieć wartość 1.1.0, a jeśli wybierzesz opcję poprawki, twoja wersja pakietu będzie mieć wartość 1.0.1.

W przypadku wybrania custom opcji należy również określić versionPublish wartość w następujący sposób:

- 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 opis
publishDirectory Lokalizacja plików, które chcesz opublikować.
vstsFeedPublish Nazwa projektu i kanału informacyjnego do opublikowania. Jeśli pracujesz z kanałem informacyjnym o zakresie organizacji, określ tylko nazwę źródła danych.
vstsFeedPackagePublish Nazwa pakietu. Musi mieć małe litery. Używaj tylko liter, cyfr i kresek.
versionOption Wybierz strategię przechowywania wersji. Opcje: major, , patchminor, custom.
versionPublish Wersja pakietu niestandardowego.
packagePublishDescription Opis zawartości pakietu.

Pobieranie pakietu uniwersalnego

Aby pobrać pakiet uniwersalny ze źródła danych w organizacji, użyj zadania Pakiet uniwersalny z poleceniem download w następujący sposób:

steps:
- task: UniversalPackages@0
  displayName: Download a Universal Package
  inputs:
    command: download
    vstsFeed: '<projectName>/<feedName>'
    vstsFeedPackage: '<packageName>'
    vstsPackageVersion: '<packageVersion>'
    downloadDirectory: '$(Build.SourcesDirectory)\someFolder'
Argument opis
vstsFeed Źródło danych Artifacts hostuje pakiet do pobrania.
vstsFeedPackage Nazwa pakietu do pobrania.
vstsPackageVersion Wersja pakietu do pobrania.
downloadDirectory Folder docelowy pakietu. Wartość domyślna: $(System.DefaultWorkingDirectory).

Aby pobrać pakiet uniwersalny ze źródła zewnętrznego, użyj następującego fragmentu kodu:

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 opis
feedsToUse Ustaw wartość na external wartość podczas pobierania ze źródła zewnętrznego.
externalFeedCredentials Nazwa połączenia usługi z zewnętrznym źródłem danych. Aby uzyskać więcej informacji, zobacz Zarządzanie połączeniami usług.
feedDownloadExternal Nazwa zewnętrznego źródła danych.
packageDownloadExternal Nazwa pakietu, który chcesz pobrać.
versionDownloadExternal Wersja pakietu, który chcesz pobrać.

Napiwek

Możesz użyć symboli wieloznacznych, aby pobrać najnowszą wersję pakietu uniwersalnego. Aby uzyskać więcej informacji, zobacz Pobieranie najnowszej wersji.