Wiederherstellen von NuGet-Paketen über die Befehlszeile (dotnet)

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

Dieser Leitfaden führt Sie durch das Konfigurieren Ihres Projekts und das Wiederherstellen Ihrer NuGet-Pakete mithilfe der dotnet-Befehlszeilenschnittstelle.

Voraussetzungen

Produkt Voraussetzungen
Azure DevOps - Eine Azure DevOps Organisation.
- Ein Azure DevOps Projekt.
- Ein Azure Artifacts-Feed.
– Laden Sie das .NET SDK Version 9.0.200 oder höher herunter, und installieren Sie es.

Richten Sie den Anmeldeinformationsanbieter für Azure Artifacts ein

Um sich für Ihren Feed zu authentifizieren, müssen Sie zunächst den Azure Artifacts-Anmeldeinformationsanbieter installieren. Mithilfe des in dotnet enthaltenen Toolinstallationsprogramms können Sie den Anmeldeinformationsanbieter über die CLI mit dem folgenden Befehl installieren:

dotnet tool install --global Microsoft.Artifacts.CredentialProvider.NuGet.Tool

Wenn Ihre Repositoryebene nuget.config so konfiguriert ist, dass nur Azure Artifacts Quellen verwendet werden, führen Sie den Installationsbefehl außerhalb dieses Verzeichnisses aus, oder legen Sie explizit nuget.org als Quelle fest:

dotnet tool install --global Microsoft.Artifacts.CredentialProvider.NuGet.Tool --source https://api.nuget.org/v3/index.json

Optional können Sie das Tool auf eine Hauptversion festlegen (z. B. in Container-Images, bei denen die Reproduzierbarkeit wichtig ist):

dotnet tool install --global Microsoft.Artifacts.CredentialProvider.NuGet.Tool --version 2.* --source https://api.nuget.org/v3/index.json

Erste Verwendung

Wenn Sie zum ersten Mal einen Vorgang ausführen, der eine Authentifizierung erfordert, verwenden Sie einen der folgenden Ansätze:

  1. Führen Sie den Befehl mit --interactive aus, damit dotnet Sie zur Anmeldung auffordern kann. Dies ist der empfohlene Ansatz für die meisten lokalen Entwicklungsszenarien.

Bevor Sie einen interaktiven Befehl ausführen, stellen Sie sicher, dass Ihr Projekt eingerichtet ist und Ihr Feed zu nuget.confighinzugefügt wird. Details zum Einrichten finden Sie unter Projektsetup.

Nachdem Ihr Projekt eingerichtet und mit Ihrem Feed verbunden ist, navigieren Sie zu Ihrem Projektverzeichnis, und führen Sie Folgendes aus:

dotnet restore --interactive

Dieser Befehl meldet Sie an und erwirbt ein Sitzungstoken. Nach erfolgreicher Anmeldung können Sie authentifizierte Befehle ohne --interactive ausführen, solange das zwischengespeicherte Sitzungstoken gültig ist. Weitere Informationen finden Sie unter Session-Tokencachespeicherorte.

  1. Für nicht interaktive Szenarien, z. B. Docker-Container und benutzerdefinierte Automatisierung, stellen Sie Anmeldeinformationen über Umweltvariablen bereit.

Verwenden Sie für Azure Pipelines die Aufgabe NuGetAuthenticate@1, um sich bei Ihrem Feed zu authentifizieren, bevor Sie Befehle wie dotnet restore oder dotnet nuget push ausführen. Weitere Informationen finden Sie unter Restore NuGet-Pakete mit Azure Pipelines.

Verbindung zu einem Feed herstellen

  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 Verbindung mit Feed herstellen aus und navigieren Sie dann auf der linken Seite zum Abschnitt NuGet und wählen Sie dotnet aus.

  4. Erstellen Sie eine nuget.config Datei im selben Ordner wie ihre csproj oder sln Datei. Kopieren Sie den folgenden XML-Codeausschnitt, und fügen Sie ihn in Ihre neue Datei ein, und ersetzen Sie die Platzhalter durch die relevanten Informationen:

  • Organisationsbezogener Feed:

    <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="<FEED_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="<FEED_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 im Navigationsbereich links Verbindung mit Feed herstellen und dann dotnet aus.

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

    Screenshot, der zeigt, wie Eine Verbindung mit einem Feed mit dotnet in Azure DevOps Server 2020 und 2022 hergestellt wird.

Wiederherstellen von Paketen

Führen Sie den folgenden Befehl aus, um Ihre Pakete wiederherzustellen. Das flag --interactive wird verwendet, um den Benutzer zur Eingabe von Anmeldeinformationen aufzufordern:

dotnet restore --interactive

Verwandte Inhalte

  • Last updated on