UniversalPackages@0 — zadanie universal packages v0

To zadanie służy do pobierania lub tworzenia pakietów uniwersalnych i publikowania ich.

Składnia

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

Dane wejściowe

command - Polecenia
string. Wymagane. Dozwolone wartości: download, publish. Wartość domyślna: download.

Określa polecenie NuGet do uruchomienia.

downloadDirectory - Katalog docelowy
string. Wymagane, gdy command = download. Wartość domyślna: $(System.DefaultWorkingDirectory).

Określa ścieżkę folderu, w której zadanie pobiera zawartość pakietu.

feedsToUse - Lokalizacja kanału informacyjnego
Alias wejściowy: internalOrExternalDownload. string. Wymagane, gdy command = download. Dozwolone wartości: internal (Ta organizacja/kolekcja), external (Inna organizacja/kolekcja). Wartość domyślna: internal.

Określa źródło danych z tej kolekcji lub innej kolekcji w usłudze Azure Artifacts.

externalFeedCredentials - połączenie organizacji/kolekcji
Alias wejściowy: externalEndpoint. string. Opcjonalny. Użyj polecenia , gdy internalOrExternalDownload = external && command = download.

Określa poświadczenia do użycia dla rejestrów zewnętrznych znajdujących się w wybranym NuGet.configobiekcie . W przypadku źródeł danych w tej organizacji lub kolekcji pozostaw to pole puste; poświadczenia kompilacji są używane automatycznie.

vstsFeed - Paszy
Alias wejściowy: feedListDownload. string. Wymagane, gdy internalOrExternalDownload = internal && command = download.

Uwzględnia wybrane źródło danych. Aby wybrać źródło danych, musisz mieć zainstalowaną i licencjonowaną usługę Azure Artifacts. Określa wartość FeedName dla źródła danych o zakresie organizacji i parametru projectName/FeedName lub ProjectID/FeedID dla źródła danych o zakresie projektu.

vstsFeedPackage - Nazwa pakietu
Alias wejściowy: packageListDownload. string. Wymagane, gdy internalOrExternalDownload = internal && command = download.

Określa nazwę pakietu do pobrania przez zadanie.

vstsPackageVersion - Wersja
Alias wejściowy: versionListDownload. string. Wymagane, gdy internalOrExternalDownload = internal && command = download.

Określa wersję pakietu lub używa zmiennej zawierającej wersję do pobrania. Ten wpis może być również wyrażeniem wieloznacznymi, takim jak *, aby uzyskać najwyższą wersję. Przykłady: 1.* pobiera najwyższą wersję z wersją główną 1 i 1.2.* otrzymuje najwyższą wersję poprawki z wersją główną 1 i wersję pomocniczą 2.

feedDownloadExternal - Źródło danych (lub projekt/kanał informacyjny, jeśli źródło danych zostało utworzone w projekcie)
string. Wymagane, gdy internalOrExternalDownload = external && command = download.

Określa kanał informacyjny w innej organizacji/kolekcji.

W przypadku źródeł danych o zakresie projektu wartość powinna mieć Project/Feedwartość , gdzie Project jest nazwą lub identyfikatorem projektu i Feed jest nazwą/identyfikatorem źródła danych. W przypadku źródeł danych o zakresie organizacji wartość powinna być tylko nazwą źródła danych.

packageDownloadExternal - Nazwa pakietu
string. Wymagane, gdy internalOrExternalDownload = external && command = download.

Określa nazwę pakietu do pobrania.

versionDownloadExternal - Wersja
string. Wymagane, gdy internalOrExternalDownload = external && command = download.

Określa wersję pakietu lub używa zmiennej zawierającej wersję do pobrania. Ten wpis może być również wyrażeniem wieloznacznymi, takim jak *, aby uzyskać najwyższą wersję. Przykłady: 1.* pobiera najwyższą wersję z wersją główną 1 i 1.2.* otrzymuje najwyższą wersję poprawki z wersją główną 1 i wersję pomocniczą 2. Wzorce wieloznaczne nie są obsługiwane w przypadku pakietów w wersji wstępnej.

publishDirectory - Ścieżka do plików do opublikowania
string. Wymagane, gdy command = publish. Wartość domyślna: $(Build.ArtifactStagingDirectory).

Określa ścieżkę do listy plików do opublikowania.

feedsToUsePublish - Lokalizacja kanału informacyjnego
Alias wejściowy: internalOrExternalPublish. string. Wymagane, gdy command = publish. Dozwolone wartości: internal (Ta organizacja/kolekcja), external (Inna organizacja/kolekcja). Wartość domyślna: internal.

Określa źródło danych z tej kolekcji lub innej kolekcji w usłudze Azure Artifacts.

publishFeedCredentials - połączenie organizacji/kolekcji
Alias wejściowy: externalEndpoints. string. Wymagane, gdy internalOrExternalPublish = external && command = publish.

Określa poświadczenia do użycia dla zewnętrznych źródeł danych.

vstsFeedPublish - Źródło danych docelowych
Alias wejściowy: feedListPublish. string. Wymagane, gdy internalOrExternalPublish = internal && command = publish.

Określa projekt i nazwę/identyfikator GUID kanału informacyjnego do opublikowania.

publishPackageMetadata - Publikowanie metadanych potoku
boolean. Opcjonalny. Użyj polecenia , gdy command = publish && internalOrExternalPublish = internal. Wartość domyślna: true.

Kojarzy metadane tego potoku kompilacji/wydania (takie jak informacje o kodzie uruchomienia i kodu źródłowego) z pakietem.

vstsFeedPackagePublish - Nazwa pakietu
Alias wejściowy: packageListPublish. string. Wymagane, gdy internalOrExternalPublish = internal && command = publish.

Określa identyfikator pakietu do opublikowania lub utworzenia nowego identyfikatora pakietu, jeśli wcześniej nigdy nie opublikowano wersji tego pakietu. Nazwy pakietów muszą mieć małe litery i mogą używać tylko liter, cyfr i kreski (-).

feedPublishExternal - Kanał informacyjny (lub projekt/kanał informacyjny, jeśli źródło danych zostało utworzone w projekcie)
string. Wymagane, gdy internalOrExternalPublish = external && command = publish.

Określa nazwę zewnętrznego źródła danych do opublikowania.

Jeśli źródło danych zostało utworzone w projekcie, wartość powinna mieć Project/Feedwartość , gdzie Project jest nazwą lub identyfikatorem projektu i Feed jest nazwą źródła danych. Jeśli źródło danych nie zostało utworzone w projekcie, wartość powinna być tylko nazwą źródła danych.

packagePublishExternal - Nazwa pakietu
string. Wymagane, gdy internalOrExternalPublish = external && command = publish.

Określa nazwę pakietu podczas publikowania w zewnętrznym kanale informacyjnym.

versionOption - Wersja
Alias wejściowy: versionPublishSelector. string. Wymagane, gdy command = publish. Dozwolone wartości: major (Następna główna), (Następna pomocnicza), minorpatch (Następna poprawka), custom. Wartość domyślna: patch.

Określa strategię przyrostu wersji. Wartość custom do ręcznego wprowadzania wersji pakietu. W przypadku nowych pakietów pierwsza wersja będzie mieć wartość 1.0.0, jeśli określisz majorwartość , 0.1.0, jeśli określisz wartość , lub 0.0.1, jeśli określisz minorpatchwartość . Aby uzyskać więcej informacji, zobacz specyfikację semantycznego przechowywania wersji .

versionPublish - Wersja niestandardowa
string. Wymagane, gdy versionPublishSelector = custom && command = publish.

Określa niestandardowy schemat wersji pakietu.

packagePublishDescription - Opis
string. Opcjonalny. Użyj polecenia , gdy command = publish.

Określa opis zawartości pakietu i/lub zmiany wprowadzone w tej wersji pakietu.

verbosity - Szczegółowości
string. Dozwolone wartości: None, , DebugTrace, Information, Warning, Error, Critical. Wartość domyślna: None.

Określa ilość szczegółów wyświetlanych w danych wyjściowych.

publishedPackageVar - Zmienna wyjściowa pakietu
string. Opcjonalny. Użyj polecenia , gdy command = publish.

Określa nazwę zmiennej, która będzie zawierać opublikowaną nazwę pakietu i wersję.

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

To zadanie służy do pobierania lub tworzenia pakietów uniwersalnych i publikowania ich.

Mój potok musi uzyskać dostęp do kanału informacyjnego w innym projekcie

Jeśli potok jest uruchomiony w innym projekcie niż projekt hostowania kanału informacyjnego, należy skonfigurować drugi projekt w celu udzielenia dostępu do odczytu/zapisu do usługi kompilacji. Aby uzyskać więcej informacji, zobacz Uprawnienia pakietu w usłudze Azure Pipelines .

Przykłady

Najprostszym sposobem rozpoczęcia pracy z zadaniem pakietu uniwersalnego jest użycie edytora zadań Pipelines do wygenerowania kodu YAML. Następnie możesz skopiować wygenerowany kod do pliku projektu azure-pipelines.yml . W tym przykładzie pokazano, jak szybko wygenerować kod YAML przy użyciu potoku, który tworzy progresywną aplikację internetową GatsbyJS (PWA).

Pakiety uniwersalne to przydatny sposób hermetyzacji i wersji aplikacji internetowej. Pakowanie aplikacji internetowej do pakietu uniwersalnego umożliwia szybkie wycofywanie do określonej wersji witryny i eliminuje konieczność skompilowania witryny w potoku wdrażania.

W tym przykładowym potoku pokazano, jak pobrać narzędzie z kanału informacyjnego w projekcie. Zadanie pakietu uniwersalnego służy do pobierania narzędzia, uruchamiania kompilacji, a następnie ponownie używa zadania Universal Package do opublikowania całego skompilowanego programu GatsbyJS PWA do źródła danych jako wersjonowanego pakietu uniwersalnego.

Pobieranie pakietu za pomocą zadania Pakiet uniwersalny

Drugie zadanie w przykładowym projekcie używa zadania Universal Package, aby pobrać narzędzie, obrazmagick, z kanału informacyjnego znajdującego się w innym projekcie w tej samej organizacji. Narzędzie imagemagick jest wymagane przez kolejny krok kompilacji w celu zmiany rozmiaru obrazów.

1. Dodaj zadanie Pakiet uniwersalny, klikając ikonę plusa, wpisując "universal" w polu wyszukiwania, a następnie klikając przycisk Dodaj , aby dodać zadanie do potoku.

   

2. Kliknij nowo dodane zadanie pakietu uniwersalnego i polecenie do Download.

3. Wybierz katalog Docelowy , który ma być używany do pobrania narzędzia.

4. Wybierz źródłową zawartość źródłową zawierającą narzędzie, ustaw nazwę pakietu i wybierz pozycję Wersja narzędzia imagemagick ze źródła źródła.

   

5. Po ukończeniu tych pól kliknij pozycję Wyświetl kod YAML , aby wyświetlić wygenerowany kod YAML.

   

6. Konstruktor zadań uniwersalnych pakietów generuje uproszczony kod YAML, który zawiera wartości inne niż domyślne. Skopiuj wygenerowany kod YAML do azure-pipelines.yml pliku w katalogu głównym repozytorium git 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
   

Publikowanie pakietu za pomocą zadania pakietu uniwersalnego

Ostatni krok w tym przykładowym potoku używa zadania Universal Package do przekazania gotowego do produkcji narzędzia Gatsby PWA, który został utworzony przez Run gatsby build krok do źródła danych jako wersja pakietu uniwersalnego. Po uruchomieniu kanału informacyjnego masz stałą kopię pełnej witryny, którą można wdrożyć u dostawcy hostingu i uruchomiono z gatsby serveprogramem .

1. Dodaj kolejne zadanie pakietu uniwersalnego na końcu potoku, klikając ikonę plusa, wpisując "universal" w polu wyszukiwania, a następnie klikając przycisk Dodaj , aby dodać zadanie do potoku. To zadanie zbiera wszystkie zasoby gotowe do produkcji utworzone przez Run gatsby build krok, tworzą wersję pakietu uniwersalnego i publikują pakiet w kanale informacyjnym.

   

2. Ustaw polecenie naPublish.

3. Ustaw ścieżkę do plików, aby opublikować w katalogu zawierającym projekt package.jsonGatsbyJS .

4. Wybierz źródło danych docelowych, nazwę pakietu i ustaw strategię przechowywania wersji.

   

5. Po ukończeniu wymaganych pól kliknij pozycję Wyświetl YAML.

6. Skopiuj wynikowy kod YAML do azure-pipelines.yml pliku tak jak wcześniej. Kod YAML dla tego przykładowego projektu jest wyświetlany poniżej.

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

W tym przykładzie pokazano, jak za pomocą konstruktora zadań Pipelines szybko wygenerować kod YAML dla zadania pakietu uniwersalnego, które następnie można umieścić w azure-pipelines.yml pliku. Konstruktor zadań pakietu uniwersalnego obsługuje wszystkie zaawansowane konfiguracje, które można utworzyć za pomocą argumentów zadania universal package .

Uwaga

Publikowanie pakietu bezpośrednio w widoku nie jest obsługiwane w usłudze Azure Artifacts. Najpierw musisz opublikować pakiet w kanale informacyjnym, a następnie podwyższyć poziom go do widoku.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	2.144.0 lub nowsza
Kategoria zadania	Pakiet