Udostępnij za pośrednictwem

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

  • Artykuł

Usługi Azure DevOps

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. Możesz użyć Azure CLI lub Azure Pipelines do publikowania i używania pakietów z Twoich kanałów Artifacts.

Notatka

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

Kopiowanie plików

Zadanie Pakiety uniwersalne w usłudze Azure Pipelines jest ustawione tak, aby używało $(Build.ArtifactStagingDirectory) jako domyślnego katalogu 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 publikacji.

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
katalog publikacji Lokalizacja plików, które chcesz opublikować.
vstsFeedPublish Nazwa projektu i kanału do publikacji. Jeśli pracujesz z kanałem informacyjnym o zakresie organizacji, określ tylko nazwę źródła danych.
publikowaniePakietuVstsFeed Nazwa pakietu. Musi być zapisane małymi literami. Używaj tylko liter, cyfr i kresek.
packagePublishDescription Opis zawartości pakietu.

Aby opublikować pakiety w kanale usługi Azure Artifacts z potoku, tożsamość potoku musi mieć rolę Wydawca kanału (Współautor) na kanale. Aby uzyskać więcej informacji, zobacz uprawnienia dla Pipelines.

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

Wersjonowanie 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: Major, Minor i Patch w formacie: Major.Minor.Patch.

Numer wersji drugorzędnej zwiększa się po dodaniu nowych funkcji, które są zgodne z poprzednimi wersjami. W takim przypadku zwiększa się numer wersji drugorzędnej i ustawia wersję naprawczą na 0 (z1.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 wersję drugorzędną i poprawkową do 0 (z2.6.5 na 3.0.0). Numer wersji poprawki powinien być zwiększany, gdy wprowadzane są 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ć wersjonowanie pakietu, dodaj parametr versionOption do pliku YAML. Opcje publikowania nowej wersji pakietu to: major, minor, patchlub 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. Dlatego jeśli masz testPackage 1.0.0i wybierzesz opcję główną, twój nowy pakiet to testPackage 2.0.0. W przypadku wybrania opcji pomocniczej wersja pakietu będzie 1.1.0, a jeśli wybierzesz opcję patch, wersja pakietu będzie 1.0.1.

W przypadku wybrania opcji custom należy również określić wartość versionPublish 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>'
Kłótnia Opis
katalog publikacji Lokalizacja plików, które chcesz opublikować.
vstsFeedPublish Nazwa projektu i kanału do opublikowania. Jeśli pracujesz z kanałem informacyjnym o zakresie organizacji, określ tylko nazwę źródła danych.
PublikacjaPakietuVstsFeed Nazwa pakietu. Musi być napisane małymi literami. Używaj tylko liter, cyfr i kresek.
opcja wersji Wybierz strategię przechowywania wersji. Opcje: major, minor, patch, custom.
publikowanie wersji 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'
Kłótnia Opis
vstsFeed Kanał Artifacts udostępnia pakiet do pobrania.
vstsFeedPackage Nazwa pakietu do pobrania.
vstsPackageVersion Wersja pakietu do pobrania.
katalog pobierania 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/Spór/Kłótnia Opis
kanałyDoUżycia Ustaw wartość na external 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ługowymi.
feedDownloadExternal Nazwa zewnętrznego źródła danych.
packageDownloadExternal Nazwa pakietu, który chcesz pobrać.
wersjaPobierzZewnętrzny 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 Pobierz najnowszą wersję.