Veröffentlichen und Herunterladen universeller Pakete mit Azure CLI

Mit universellen Paketen können Sie andere Arten von Paketen als die häufig verwendeten Pakete wie NuGet, npm, Maven oder Python-Pakete speichern. Mit Azure CLI können Sie universelle Pakete über die Befehlszeile veröffentlichen und herunterladen. Hochgeladene Pakete können in der Größe (bis zu 4 TB) variieren, sollten jedoch immer einen Namen und eine Versionsnummer aufweisen. In diesem Artikel werden Sie durch die Schritte zum Veröffentlichen und Herunterladen Ihrer universellen Pakete in Azure Artifacts-Feeds geführt.

Voraussetzungen

  1. Azure-Befehlszeilenschnittstelle
  2. Wenn Sie Linux verwenden, stellen Sie sicher, dass Sie die .NET-Version unter Linux installieren.
  3. Azure DevOps Services Konto.
  4. Azure-Artefaktefeed.

Verbindungseinrichtung

  1. Führen Sie den folgenden Befehl aus, um die Version von Azure CLI-Modulen und Erweiterungen zu überprüfen, die Sie derzeit haben:

    az --version
    
  2. Installieren Sie die Azure DevOps-Erweiterung.

    az extension add --name azure-devops
    
  3. Wenn Sie bereits über die Azure DevOps-Erweiterung verfügen, aber auf die neueste Version aktualisieren möchten, führen Sie den folgenden Befehl aus:

    az extension update --name azure-devops
    
  4. Melden Sie sich bei Azure an.

    az login
    

Tipp

Führen Sie die Ausführung aus az login --allow-no-subscription, um auf Mandanten ohne Abonnements zuzugreifen.

  1. Legen Sie Ihr Projekt und Ihre Organisation als Standardeinstellung der CLI fest.

    az devops configure --defaults project=<YOUR_PROJECT_NAME> organization=https://dev.azure.com/<YOUR_ORGANIZATION_NAME> 
    

Veröffentlichen universeller Pakete

Um ein universelles Paket zu veröffentlichen, führen Sie den folgenden Befehl in einer Eingabeaufforderung mit erhöhten Rechten aus. Paketnamen müssen Kleinbuchstaben, Anfang und Ende mit Buchstaben oder Zahlen sein und nur Buchstaben, Zahlen und nicht aufeinander folgende Striche, Unterstriche und Punkte enthalten. Paketversionen müssen Kleinbuchstaben ohne Buildmetadaten (+ Suffix) sein. Weitere Informationen zur semantischen Versionsverwaltung finden Sie unter SemVer .

Der folgende Befehl veröffentlicht ein universelles Paket in einem organisationsbezogenen Feed:

az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --description <PACKAGE_DESCRIPTION> --path <PACKAGE_DIRECTORY>

Veröffentlichte Pakete anzeigen

  1. Navigieren Sie zu Ihrer Azure DevOps-Organisation.

  2. Wählen Sie Ihr Projekt aus, und wählen Sie dann Artefakte aus.

  3. Wählen Sie ihren Feed aus dem Dropdownmenü aus.

    Screenshot des neu veröffentlichten universellen Pakets.

Universelle Pakete herunterladen

Um ein universelles Paket mit Azure CLI herunterzuladen, führen Sie den folgenden Befehl in einer Eingabeaufforderung mit erhöhten Rechten aus.

az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME>  --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>

Herunterladen bestimmter Dateien

Wenn Sie nur bestimmte Dateien herunterladen möchten, können Sie den --file-filter Parameter verwenden, um eine Teilmenge von Dateien herunterzuladen.

Beispiel: --file-filter *logs/*.log Würde jeder Datei entsprechen, die mit Protokollen endet und mit der Erweiterung .log (Beispiel: build123_logs.log). Weitere Details finden Sie in der Referenz zu Dateiabgleichsmustern .

az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION>  --path <DOWNLOAD_PATH>  --file-filter <MATCH_PATTERN>

Herunterladen der aktuellen Version

Sie können Wildcards verwenden, um die neueste Version Ihrer Universellen Pakete herunterzuladen.

Beispiele:

  • --version '*': die neueste Version.

  • --version '1.*': die neueste Version mit Haupt 1.

  • --version '1.2.*': die neueste Patchversion mit Major 1 und Minor 2.

Hinweis

Wildcardmuster werden nicht mit Vorabversionen unterstützt (Pakete mit einem Strich in ihrer Versionsnummer).