UniversalPackages@0: Aufgabe "Universelle Pakete v0"

Verwenden Sie diese Aufgabe, um Universalpakete 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.

Eingaben

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

Gibt den auszuführenden NuGet-Befehl an.

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

Gibt den Ordnerpfad an, in den der Task den Inhalt des Pakets herunterlädt.

feedsToUse - Feedspeicherort
Eingabealias: internalOrExternalDownload. string. Erforderlich, wenn command = download. Zulässige Werte: internal (This organization/collection), external (Another organization/collection). Standardwert. internal.

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

externalFeedCredentials - organization-/Sammlungsverbindung
Eingabealias: externalEndpoint. string. Optional. Verwenden Sie , wenn internalOrExternalDownload = external && command = download.

Gibt die Anmeldeinformationen an, die für externe Registrierungen verwendet werden sollen, die sich im ausgewählten NuGet.configbefinden. Lassen Sie für Feeds in dieser organization oder Sammlung dieses Werts leer. Die Anmeldeinformationen des Builds werden automatisch verwendet.

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

Schließt den ausgewählten Feed ein. Azure Artifacts muss installiert und lizenziert sein, damit Sie hier einen Feed auswählen können. Gibt den FeedName für einen organization-Bereichsfeed und projectName/FeedName oder ProjectID/FeedID für einen Projektbereichsfeed an.

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

Gibt den Namen des Pakets für die aufgabe an, die heruntergeladen werden soll.

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

Gibt die Paketversion an oder verwendet eine Variable, die die herunterzuladende Version enthält. Dieser Eintrag kann auch ein Wildcardausdruck wie *sein, um die höchste Version zu erhalten. Beispiele: 1.* Ruft die höchste Version mit Hauptversion 1 ab und 1.2.* erhält die höchste Patchversion mit Hauptversion 1 und Nebenversion 2.

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

Gibt einen Feed in einer anderen organization/Auflistung an.

Für projektbezogene Feeds sollte der Wert sein Project/Feed, wobei Project der Name oder die ID des Projekts und Feed der Name bzw. die ID des Feeds ist. Bei organization Feeds sollte der Wert nur der Feedname sein.

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

Gibt den Namen des Pakets an, das heruntergeladen werden soll.

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

Gibt die Paketversion an oder verwendet eine Variable, die die herunterzuladende Version enthält. Dieser Eintrag kann auch ein Wildcardausdruck wie *sein, um die höchste Version zu erhalten. Beispiele: 1.* Ruft die höchste Version mit Hauptversion 1 ab und 1.2.* erhält die höchste Patchversion mit Hauptversion 1 und Nebenversion 2. Platzhaltermuster werden bei Paketen aus Vorabreleases nicht unterstützt.

publishDirectory - Pfad zu zu veröffentlichenden Dateien
string. Erforderlich, wenn command = publish. Standardwert. $(Build.ArtifactStagingDirectory).

Gibt den Pfad zur Liste der Dateien an, die veröffentlicht werden sollen.

feedsToUsePublish - Feedspeicherort
Eingabealias: internalOrExternalPublish. string. Erforderlich, wenn command = publish. Zulässige Werte: internal (This organization/collection), external (Another organization/collection). Standardwert. internal.

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

publishFeedCredentials - organization-/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 den Namen/die GUID des Feeds an, in dem veröffentlicht werden soll.

publishPackageMetadata - Veröffentlichen von Pipelinemetadaten
boolean. Optional. Verwenden Sie , wenn command = publish && internalOrExternalPublish = internal. Standardwert. true.

Ordnet die Metadaten dieser Build-/Releasepipeline (z. B. Ausführungs- 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 Bindestriche (-) verwenden.

feedPublishExternal - Feed (oder Projekt/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 sein Project/Feed, wobei Project der Name oder die ID des Projekts 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 bei der Veröffentlichung in einem externen Feed an.

versionOption - Version
Eingabealias: versionPublishSelector. string. Erforderlich, wenn command = publish. Zulässige Werte: major (Nächste Hauptversion), minor (Nächste Nebenversion), patch (Nächster Patch), custom. Standardwert. patch.

Gibt eine Version inkrementierungsstrategie an. Der custom Wert, mit dem Die Paketversion manuell eingegeben werden soll. Für neue Pakete ist die erste Version 1.0.0, wenn Sie majorangeben, 0.1.0, wenn Sie angeben minor, oder 0.0.1, wenn Sie angeben patch. Weitere Informationen finden Sie in der Spezifikation für die semantische Versionsverwaltung .

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

Gibt ein benutzerdefiniertes Versionsschema für das Paket an.

packagePublishDescription - Beschreibung
string. Optional. Verwenden Sie , 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, InformationDebug, Warning, Error, , , Critical. Standardwert. None.

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

publishedPackageVar - Paketausgabevariable
string. Optional. Verwenden Sie , wenn command = publish.

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

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Bemerkungen

Verwenden Sie diese Aufgabe, um Universalpakete 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 als dem Projekt ausgeführt wird, 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 für die ersten Schritte mit der Aufgabe „Universalpaket“ besteht darin, den Aufgaben-Editor von Pipelines zum Generieren des YAML-Codes zu verwenden. Anschließend können Sie den generierten Code in die Datei azure-pipelines.yml Ihres Projekts kopieren. In diesem Beispiel wird veranschaulicht, wie Sie den YAML-Code mithilfe einer Pipeline schnell generieren, die eine progressive GatsbyJS-Web-App (PWA) erstellt.

Universalpakete bieten eine hilfreiche Möglichkeit, eine Web-App zu kapseln und zu versionieren. Das Packen einer Web-App in ein Universalpaket 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 innerhalb Ihres Projekts abrufen. Die Aufgabe „Universalpaket“ wird verwendet, um das Tool herunterzuladen, einen Build auszuführen und die Aufgabe „Universalpaket“ erneut zu verwenden, um die gesamte kompilierte GatsbyJS-PWA als versioniertes Universalpaket in einem Feed zu veröffentlichen.

Herunterladen eines Pakets mit der Aufgabe „Universalpaket“

Die zweite Aufgabe im Beispielprojekt verwendet die Aufgabe „Universalpaket“, 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 den Task Universelles Paket hinzu, indem Sie auf das Plussymbol klicken, im Suchfeld "universell" eingeben und auf die Schaltfläche Hinzufügen klicken, um die Aufgabe Ihrer Pipeline hinzuzufügen.

   

2. Wählen Sie die neu hinzugefügte Aufgabe Universalpaket und den BefehlDownload aus.

3. Wählen Sie das Zielverzeichnis aus, das für den Download des Tools verwendet werden soll.

4. Wählen Sie einen Quellfeed aus, der das Tool enthält, legen Sie den Paketnamen fest, und wählen Sie version des imagemagick-Tools aus dem Quellfeed aus.

   

5. Wählen Sie nach dem Ausfüllen der Felder YAML anzeigen aus, um den generierten YAML-Code anzuzeigen.

   

6. Der Generator für die Aufgabe Universalpaket generiert vereinfachten YAML-Code, der andere Werte als die 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 „Universalpaket“

Im letzten Schritt dieser Beispielpipeline wird die Aufgabe „Universalpaket“ verwendet, um die produktionsbereite Gatsby-PWA, die durch den Schritt Run gatsby build erstellt wurde, als versioniertes Universalpaket in einen Feed hochzuladen. Wenn es sich in einem Feed befindet, verfügen Sie über eine dauerhafte Kopie Ihrer vollständigen Website, die für den Hostinganbieter bereitgestellt und mit gatsby serve gestartet werden kann.

1. Fügen Sie am Ende der Pipeline eine weitere Universelle Paketaufgabe hinzu, indem Sie auf das Pluszeichen klicken, im Suchfeld "universell" eingeben und auf die Schaltfläche Hinzufügen klicken, um die Aufgabe Ihrer Pipeline hinzuzufügen. Diese Aufgabe erfasst alle produktionsbereiten Ressourcen, die beim Schritt Run gatsby build erstellt wurden, generiert daraus ein versioniertes Universalpaket und veröffentlicht das Paket in einem Feed.

   

2. Legen Sie Befehl auf Publish fest.

3. Legen Sie Pfad zu den Dateien für die Veröffentlichung auf das Verzeichnis fest, das die Datei package.json Ihres GatsbyJS-Projekts enthält.

4. Wählen Sie einen Zielfeed und einen Paketnamen aus, und legen Sie Ihre Strategie für die Versionsverwaltung fest.

   

5. Nachdem Sie die erforderlichen Felder ausgefüllt haben, Wählen Sie YAML anzeigen aus.

6. Kopieren Sie den resultierenden YAML-Code wie zuvor in Ihre Datei azure-pipelines.yml. Der YAML-Code 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 veranschaulicht, wie Sie mithilfe des Aufgaben-Generators von Pipelines schnell den YAML-Code für die Aufgabe „Universalpaket“ generieren, der dann in Ihre Datei azure-pipelines.yml eingefügt werden kann. Der Generator für die Aufgabe „Universalpaket“ unterstützt alle erweiterten Konfigurationen, die mit den Argumenten der Aufgabe Universalpaket erstellt werden können.

Hinweis

Das direkte Veröffentlichen eines Pakets in einer Ansicht wird in Azure Artifacts nicht unterstützt. Sie müssen das Paket zunächst in Ihrem Feed veröffentlichen und dann zu einer Ansicht heraufstufen.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	2.144.0 oder höher
Aufgabenkategorie	Paket