Veröffentlichen von NuGet-Paketen über die Befehlszeile (NuGet.exe)

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Dieser Artikel führt Sie durch das Einrichten Ihres Projekts und veröffentlichen Sie Ihre NuGet-Pakete mithilfe der Befehlszeilenschnittstelle NuGet.

Voraussetzungen

Produkt Voraussetzungen
Azure DevOps - Eine Azure DevOps Organisation.
- Ein Azure DevOps Projekt.
- Ein Azure Artifacts-Feed.
– Herunterladen und Installieren nuget.exe Version 4.8.0.5385 oder höher. Wir empfehlen NuGet 5.5.x oder höher, das wichtige Fehlerbehebungen für Abbrüche und Timeouts enthält.

Richten Sie den Anmeldeinformationsanbieter für Azure Artifacts ein

Der Azure Artifacts-Anmeldeinformationsanbieter ermöglicht die sichere Authentifizierung bei Ihren Azure Artifacts-Feeds. Um es mit nuget.exezu verwenden, müssen Sie es zuerst zum Plug-In-Suchpfad von NuGet hinzufügen. Ausführliche Informationen finden Sie unter Plug-In-Installation und Ermittlung. Nachdem das Plug-In hinzugefügt wurde, führen Sie die Installationsschritte für Ihr Betriebssystem aus:

Verwenden Sie eine der folgenden Methoden, um den Anmeldeinformationsanbieter für Azure Artifacts zu installieren:

Manuelle Installation

  1. Laden Sie die neueste version Microsoft.NetFx48.NuGet.CredentialProvider.zip herunter.

  2. Extrahieren Sie die ZIP-Datei.

  3. Kopieren Sie den netfx Ordner aus dem extrahierten Archiv in %UserProfile%/.nuget/plugins/. Der netfx Ordner ist für nuget.exe Kompatibilität erforderlich.

Installieren mit dem Hilfsskript

Alternativ können Sie das automatisierte Hilfsskript für eine optimierte Installation verwenden. Stellen Sie sicher, dass Sie über PowerShell 5.1 oder höher verfügen, und führen Sie dann Folgendes aus:

iex "& { $(irm https://aka.ms/install-artifacts-credprovider.ps1) } -AddNetfx"

Weitere Informationen finden Sie im Repository Azure Artifacts Credential Provider.

Mit einem Feed verbinden

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann Ihren Feed im Dropdownmenü aus.

  3. Wählen Sie im Navigationsbereich links Verbindung mit Feed herstellen und dann NuGet.exe aus.

  4. Fügen Sie Ihrem Projekt eine nuget.config Datei in demselben Ordner wie ihre CSPROJ-- oder .sln-Datei hinzu. Fügen Sie den bereitgestellten XML-Codeausschnitt in Ihre Datei ein. Der Codeausschnitt sollte wie folgt aussehen:

    • Organisationsspezifischer Feed:

      <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
  </packageSources>
</configuration>

    • Projektbezogener Feed:

      <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
  </packageSources>
</configuration>

  1. Melden Sie sich bei Ihrem Azure DevOps-Server an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann Ihren Feed aus.

  3. Wählen Sie Verbinden mit Feed, und wählen Sie dann NuGet.exe aus dem linken Navigationsbereich.

  4. Befolgen Sie die Anweisungen im Abschnitt Project-Setup, um eine Verbindung mit Ihrem Feed herzustellen.

Veröffentlichen von Paketen in einem Feed in derselben Organisation

Anmerkung

Um Pakete in einem Feed zu veröffentlichen, müssen Sie feed Publisher (Mitwirkender) oder höher sein. Weitere Details finden Sie unter Verwalten von Berechtigungen.

Führen Sie den folgenden Befehl aus, um ein Paket in Ihrem Feed zu veröffentlichen. Ersetzen Sie die Platzhalter durch die entsprechenden Werte:

nuget push <PACKAGE_PATH> -src https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json -ApiKey <ANY_STRING>

Beispiel:

nuget push MyPackage.5.0.2.nupkg -src https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ

Anmerkung

Die api-key ist erforderlich, Sie können jedoch beim Veröffentlichen in einem Azure Artifacts-Feed eine beliebige Zeichenfolge als Wert angeben.

Veröffentlichen von Paketen in einem Feed in einer anderen Organisation

Um Ihre NuGet-Pakete in einem Feed in einer anderen Azure DevOps-Organisation zu veröffentlichen, müssen Sie zuerst ein persönliches Zugriffstoken (PERSONAL Access Token, PAT) in der Zielorganisation erstellen.

  1. Navigieren Sie zu der Organisation, die Ihren Zielfeed hostet, erstellen Sie ein persönliches Zugriffstoken (Personal Access Token, PAT) und legen Sie den Gültigkeitsbereich des Tokens auf Verpacken>Lesen und Schreiben fest.

  2. Führen Sie den folgenden Befehl aus, um die Paketquelle zu Ihrer nuget.config Datei hinzuzufügen. Dadurch wird Ihr PAT zu Ihrer nuget.config Datei hinzugefügt. Speichern Sie diese Datei an einem sicheren Speicherort, und stellen Sie sicher, dass Sie sie nicht in die Quellcodeverwaltung einchecken.

    nuget sources Add -Name <SOURCE_NAME> -Source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json -UserName <USER_NAME> -Password <PERSONAL_ACCESS_TOKEN> -config <PATH_TO_NUGET_CONFIG_FILE>

  3. Führen Sie den folgenden Befehl aus, um Ihr Paket zu veröffentlichen:

    nuget push <PACKAGE_PATH> -src <SOURCE_NAME> -ApiKey <ANY_STRING>

Beispiel:

nuget sources Add -Name "MySource" -Source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json -UserName MyUserName -Password YourPersonalAccessToken -config ./nuget.config
nuget push nupkgs/mypackage.1.1.8.nupkg -src MySource -ApiKey AZ

Anmerkung

Wenn Ihre Organisation eine Firewall oder einen Proxyserver verwendet, stellen Sie sicher, dass Sie Azure Artifacts Domain URLs und IP-Adressenzulassen.

Verwandte Inhalte

  • Last updated on