UniversalPackages@0 – Aufgabe "Universelle Pakete v0"

Verwenden Sie diese Aufgabe, um universelle Pakete herunterzuladen oder zu packen und zu veröffentlichen.

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.

Eingänge

command - Command
string. Erforderlich. Zulässige Werte: download, publish. Standardwert: download.

Gibt den auszuführenden Befehl für das universelle Paket an.

downloadDirectory - Zielverzeichnis
string. Erforderlich, wenn command = download. Standardwert: $(System.DefaultWorkingDirectory).

Gibt den Ordnerpfad an, in dem die Aufgabe den Inhalt des Pakets herunterlädt.

feedsToUse - Feedspeicherort
Eingabealias: internalOrExternalDownload. string. Erforderlich, wenn command = download. Zulässige Werte: internal (Diese Organisation/Sammlung), external (eine andere Organisation/Sammlung). Standardwert: internal.

Gibt einen Feed aus dieser Auflistung oder einer anderen Auflistung in Azure Artifacts an.

externalFeedCredentials - Organisations-/Sammlungsverbindung
Eingabealias: externalEndpoint. string. Wahlfrei. Wird verwendet, wenn internalOrExternalDownload = external && command = download.

Gibt die Anmeldeinformationen an, die für externe Registrierungen verwendet werden sollen, die sich in der ausgewählten NuGet.configbefinden. Für Feeds in dieser Organisation oder Sammlung lassen Sie dieses Leerzeichen; die Anmeldeinformationen des Builds werden automatisch verwendet.

vstsFeed - Feed-
Eingabealias: feedListDownload. string. Erforderlich, wenn internalOrExternalDownload = internal && command = download.

Enthält den ausgewählten Feed. Sie müssen Azure Artifacts installiert und lizenziert haben, um hier einen Feed auszuwählen. Gibt die FeedName- für einen feed mit Organisationsbereich und projectName/FeedName oder ProjectID/FeedID- für einen projektbezogenen Feed an.

vstsFeedPackage - Paketname
Eingabealias: packageListDownload. string. Erforderlich, wenn internalOrExternalDownload = internal && command = download.

Gibt den Namen des Pakets für die herunterzuladende Aufgabe an.

vstsPackageVersion - Version
Eingabealias: versionListDownload. string. Erforderlich, wenn internalOrExternalDownload = internal && command = download.

Gibt die Paketversion an oder verwendet eine Variable, die die version zum Herunterladen enthält. Dieser Eintrag kann auch ein Wildcardausdruck sein, z. B. *, um die höchste Version abzurufen. Beispiele: 1.* erhält die höchste Version mit Der Hauptversion 1, und 1.2.* erhält die höchste Patchversion mit Hauptversion 1 und Nebenversion 2.

feedDownloadExternal - Feed (oder Project/Feed, wenn der Feed in einem Projekt erstellt wurde)
string. Erforderlich, wenn internalOrExternalDownload = external && command = download.

Gibt einen Feed in einer anderen Organisation/Auflistung an.

Bei projektbezogenen Feeds sollte der Wert Project/Feedsein, wobei Project der Name oder die ID des Projekts ist und Feed der Name/DIE ID des Feeds ist. Bei Feeds mit Organisationsbereich sollte der Wert nur der Feedname sein.

packageDownloadExternal - Paketname
string. Erforderlich, wenn internalOrExternalDownload = external && command = download.

Gibt den paketnamen an, der heruntergeladen werden soll.

versionDownloadExternal - Version
string. Erforderlich, wenn internalOrExternalDownload = external && command = download.

Gibt die Paketversion an oder verwendet eine Variable, die die version zum Herunterladen enthält. Dieser Eintrag kann auch ein Wildcardausdruck sein, z. B. *, um die höchste Version abzurufen. Beispiele: 1.* erhält die höchste Version mit Der Hauptversion 1, und 1.2.* erhält die höchste Patchversion mit Hauptversion 1 und Nebenversion 2. Wildcardmuster werden bei Vorabversionspaketen nicht unterstützt.

publishDirectory - Pfad zu Datei(n) zum Veröffentlichen
string. Erforderlich, wenn command = publish. Standardwert: $(Build.ArtifactStagingDirectory).

Gibt den Pfad zur Liste der zu veröffentlichenden Dateien an.

feedsToUsePublish - Feedspeicherort
Eingabealias: internalOrExternalPublish. string. Erforderlich, wenn command = publish. Zulässige Werte: internal (Diese Organisation/Sammlung), external (eine andere Organisation/Sammlung). Standardwert: internal.

Gibt einen Feed aus dieser Auflistung oder einer anderen Auflistung in Azure Artifacts an.

publishFeedCredentials - Organisations-/Sammlungsverbindung
Eingabealias: externalEndpoints. string. Erforderlich, wenn internalOrExternalPublish = external && command = publish.

Gibt die Anmeldeinformationen an, die für externe Feeds verwendet werden sollen.

vstsFeedPublish - Zielfeed-
Eingabealias: feedListPublish. string. Erforderlich, wenn internalOrExternalPublish = internal && command = publish.

Gibt das Projekt und die GUID des Feeds an, in dem veröffentlicht werden soll.

publishPackageMetadata - Veröffentlichen von Pipelinemetadaten
boolean. Wahlfrei. Wird verwendet, wenn command = publish && internalOrExternalPublish = internal. Standardwert: true.

Ordnet die Metadaten dieser Build-/Releasepipeline (z. B. Run # und Quellcodeinformationen) dem Paket zu.

vstsFeedPackagePublish - Paketname
Eingabealias: packageListPublish. string. Erforderlich, wenn internalOrExternalPublish = internal && command = publish.

Gibt eine Paket-ID an, die veröffentlicht werden soll, oder erstellt eine neue Paket-ID, wenn Sie noch nie eine Version dieses Pakets veröffentlicht haben. Paketnamen müssen Kleinbuchstaben sein und dürfen nur Buchstaben, Zahlen und Gedankenstriche (-) verwenden.

feedPublishExternal - Feed (oder Project/Feed, wenn der Feed in einem Projekt erstellt wurde)
string. Erforderlich, wenn internalOrExternalPublish = external && command = publish.

Gibt den Namen des externen Feeds an, in dem veröffentlicht werden soll.

Wenn der Feed in einem Projekt erstellt wurde, sollte der Wert Project/Feedwerden, wobei Project der Name oder die ID des Projekts ist und Feed der Name des Feeds ist. Wenn der Feed nicht in einem Projekt erstellt wurde, sollte der Wert nur der Feedname sein.

packagePublishExternal - Paketname
string. Erforderlich, wenn internalOrExternalPublish = external && command = publish.

Gibt den Paketnamen beim Veröffentlichen in einem externen Feed an.

versionOption - Version
Eingabealias: versionPublishSelector. string. Erforderlich, wenn command = publish. Zulässige Werte: major (Next major), minor (Next minor), patch (Next patch), custom. Standardwert: patch.

Gibt eine Versioninkrementierungsstrategie an. Der custom Wert, um Die Paketversion manuell einzugeben. Bei neuen Paketen ist die erste Version 1.0.0, wenn Sie major, 0.1.0 angeben, wenn Sie minoroder 0.0.1 angeben, wenn Sie patchangeben. Weitere Informationen finden Sie unter Semantikversionsspezifikation.

versionPublish - benutzerdefinierte Version
string. Erforderlich, wenn versionPublishSelector = custom && command = publish.

Gibt ein benutzerdefiniertes Versionsschema für das Paket an.

packagePublishDescription - Beschreibung
string. Wahlfrei. Wird verwendet, wenn command = publish.

Gibt die Beschreibung des Paketinhalts und/oder der Änderungen an, die in dieser Version des Pakets vorgenommen wurden.

verbosity - Ausführlichkeit
string. Zulässige Werte: None, Trace, Debug, Information, Warning, Error, Critical. Standardwert: None.

Gibt die Menge an Details an, die in der Ausgabe angezeigt werden.

publishedPackageVar - Paketausgabevariable
string. Wahlfrei. Wird verwendet, wenn command = publish.

Gibt einen Namen für die Variable an, die den veröffentlichten Paketnamen und die veröffentlichte Version enthält.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Nichts.

Bemerkungen

Verwenden Sie diese Aufgabe, um universelle Pakete herunterzuladen oder zu packen und zu veröffentlichen.

Meine Pipeline muss auf einen Feed in einem anderen Projekt zugreifen.

Wenn die Pipeline in einem anderen Projekt ausgeführt wird als das Projekt, das den Feed hostet, müssen Sie das andere Projekt einrichten, um Lese-/Schreibzugriff auf den Builddienst zu gewähren. Weitere Informationen finden Sie unter Paketberechtigungen in Azure Pipelines.

Beispiele

Die einfachste Möglichkeit, mit der Aufgabe "Universal Package" zu beginnen, besteht darin, den Pipelines-Aufgaben-Editor zum Generieren des YAML zu verwenden. Anschließend können Sie den generierten Code in die azure-pipelines.yml-Datei Ihres Projekts kopieren. In diesem Beispiel wird veranschaulicht, wie Sie das YAML schnell mithilfe einer Pipeline generieren, die eine progressive GatsbyJS-Web-App (PWA) erstellt.

Universelle Pakete sind eine nützliche Möglichkeit, sowohl eine Web-App zu kapseln als auch eine Web-App zu versionieren. Das Packen einer Web-App in ein universelles Paket ermöglicht schnelle Rollbacks auf eine bestimmte Version Ihrer Website und beseitigt die Notwendigkeit, die Website in der Bereitstellungspipeline zu erstellen.

In dieser Beispielpipeline wird veranschaulicht, wie sie ein Tool aus einem Feed in Ihrem Projekt abrufen. Die Aufgabe "Universelles Paket" wird verwendet, um das Tool herunterzuladen, einen Build auszuführen, und erneut verwendet die Aufgabe "Universal Package", um die gesamte kompilierte GatsbyJS-PWA in einem Feed als versionsiertes Universelles Paket zu veröffentlichen.

Herunterladen eines Pakets mit der Universellen Paketaufgabe

Der zweite Vorgang im Beispielprojekt verwendet den Universal Package-Vorgang, um ein Tool, imagemagick, aus einem Feed abzurufen, der sich in einem anderen Projekt in derselben Organisation befindet. Das Tool imagemagick ist für den nachfolgenden Buildschritt erforderlich, um die Größe von Bildern zu ändern.

1. Fügen Sie die Aufgabe "Universelles Paket" hinzu, indem Sie auf das Plussymbol klicken, im Suchfeld "Universell" eingeben und auf die Schaltfläche " hinzufügen" klicken, um der Pipeline die Aufgabe hinzuzufügen.

   

2. Klicken Sie auf die neu hinzugefügte aufgabe Universal Package und die Command to Download.

3. Wählen Sie das Zielverzeichnis aus, zum Herunterladen des Tools verwendet werden soll.

4. Wählen Sie eine Quelle Feed- aus, die das Tool enthält, legen Sie den Paketnamenfest, und wählen Sie Version des Imagemagick-Tools aus der Quelle Feedaus.

   

5. Klicken Sie nach Abschluss der Felder auf YAML- anzeigen, um das generierte YAML anzuzeigen.

   

6. Der Universal Package Aufgaben-Generator generiert vereinfachtes YAML, das keine Standardwerte enthält. Kopieren Sie das generierte YAML in Ihre azure-pipelines.yml Datei im Stammverzeichnis des Git-Repositorys Ihres Projekts.

   # 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
   

Veröffentlichen eines Pakets mit der Aufgabe "Universelles Paket"

Der letzte Schritt in dieser Beispielpipeline verwendet die Aufgabe "Universal Package", um die produktionsbereite Gatsby-PWA hochzuladen, die vom Run gatsby build Schritt in einen Feed als versionsgesteuertes Universelles Paket erstellt wurde. Sobald Sie sich in einem Feed befinden, verfügen Sie über eine permanente Kopie Ihrer vollständigen Website, die für den Hostinganbieter bereitgestellt und mit gatsby servebegonnen werden kann.

1. Fügen Sie am Ende der Pipeline eine weitere Universelle Paketaufgabe hinzu, indem Sie auf das Plussymbol klicken, im Suchfeld "universell" eingeben und auf die Schaltfläche " hinzufügen" klicken, um die Aufgabe zu Ihrer Pipeline hinzuzufügen. Diese Aufgabe sammelt alle produktionsfertigen Ressourcen, die vom Run gatsby build Schritt erstellt werden, ein versionsgesteuertes Universelles Paket erstellen und das Paket in einem Feed veröffentlichen.

   

2. Legen Sie die Command- auf Publishfest.

3. Legen Sie Pfad zu Dateien fest, um im Verzeichnis zu veröffentlichen, das die package.jsonIhres GatsbyJS-Projekts enthält.

4. Wählen Sie einen Zielfeed, einen Paketnamen und legen Sie Ihre Versionsverwaltungsstrategie fest.

   

5. Klicken Sie nach Abschluss der erforderlichen Felder auf YAML-anzeigen.

6. Kopieren Sie das resultierende YAML wie zuvor in Ihre azure-pipelines.yml Datei. Das YAML für dieses Beispielprojekt wird unten angezeigt.

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

In diesem Beispiel wurde gezeigt, wie Sie mithilfe des Pipelines-Aufgaben-Generators schnell das YAML für die Aufgabe "Universal Package" generieren können, die dann in Ihre azure-pipelines.yml Datei eingefügt werden kann. Der Task-Generator für universelle Pakete unterstützt alle erweiterten Konfigurationen, die mit Universal Package Aufgabenargumenten erstellt werden können.

Anmerkung

Das direkte Veröffentlichen eines Pakets in einer Ansicht wird in Azure Artifacts nicht unterstützt. Sie müssen das Paket zuerst in Ihrem Feed veröffentlichen und dann in eine Ansicht höher stufen.

Anforderungen

Anforderung	Beschreibung
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	2.144.0 oder höher
Vorgangskategorie	Paket