Wiederherstellung von NuGet Paketen mit Azure Pipelines (YAML/Classic)

Azure DevOps Server | Azure DevOps Server 2022 - Azure DevOps Server 2019

Mit der NuGet-Paketwiederherstellung können Sie alle Abhängigkeiten Ihres Projekts installieren, ohne sie in der Quellcodeverwaltung speichern zu müssen. Dies ermöglicht eine sauberere Entwicklungsumgebung und eine kleinere Repositorygröße. Sie können Ihre NuGet-Pakete mithilfe der NuGet-Wiederherstellungsaufgabe, der NuGet CLI oder der .NET Core CLI wiederherstellen. Dieser Artikel gibt Ihnen eine Anleitung zur Wiederherstellung Ihrer NuGet Pakete mit Classic und YAML Pipelines.

Voraussetzungen

• Erstellen Sie eine Azure DevOps-Organisation und ein Projekt, falls noch nicht geschehen.

• Erstellen Sie einen neuen Feed, wenn Sie noch keinen haben.

• Wenn Sie einen selbst gehosteten Agent verwenden, stellen Sie sicher, dass es das .NET Core SDK (2.1.400+) und NuGet (4.8.0.5385+) installiert hat.

Hinweis

Wenn Sie Ubuntu 24.04 oder höher verwenden, müssen Sie die NuGetAuthenticate Aufgabe mit der .NET CLI anstelle der nuget.exeverwenden. Weitere Informationen finden Sie unter Support für neuere Ubuntu-gehostete Images.

Wiederherstellung von NuGet Paketen aus einem Feed in derselben Organisation

YAML

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

2. Wählen Sie Pipelines und dann Ihre Pipelinedefinition aus.

3. Wählen Sie Bearbeiten aus, und fügen Sie dann der YAML-Pipeline den folgenden Codeausschnitt hinzu.

   steps:
   - task: NuGetAuthenticate@1
   
   - task: NuGetToolInstaller@1
     inputs:
       versionSpec: '*'
       checkLatest: true
   
   - script: nuget restore <SOLUTION_PATH>    ## If you're using Ubuntu 24.04 or later, use the following command instead: dotnet restore <SOLUTION_PATH>
   

Klassisch

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

2. Wählen Sie Pipelines, Ihre Pipelinedefinition und dann Bearbeiten aus.

3. Wählen Sie + aus, um eine neue Aufgabe hinzuzufügen. Fügen Sie der Pipelinedefinition die Aufgaben NuGet tool installer, NuGet Authenticate und Befehlszeile hinzu. Sie können für die Aufgaben NuGet tool installer und NuGet Authenticate die Standardeinstellungen beibehalten und die Aufgabe Befehlszeile wie folgt konfigurieren:

   • Anzeigename: Wiederherstellen.
   • Skript: nuget.exe restore <SOLUTION_PATH>. Wenn Sie Ubuntu 24.04 oder höher verwenden, verwenden Sie stattdessen den folgenden Befehl: dotnet restore <SOLUTION_PATH>

4. Wählen Sie Speichern & in Warteschlange einreihen aus, wenn Sie fertig sind.

Hinweis

Stellen Sie sicher, dass der NuGet Katalog Upstream in Ihrem Feed aktiviert ist. Weitere Informationen finden Sie unter Aktivieren von Upstream-Quellen in einem bestehenden Feed.

Wiederherstellen von NuGet Paketen aus einem Feed in einer anderen Organisation

Um NuGet Pakete aus einem Feed in einer anderen Azure DevOps Organisation wiederherzustellen, müssen Sie zunächst ein persönliches Zugriffstoken erstellen und damit eine NuGet Service Verbindung einrichten.

Erstellen eines persönlichen Zugriffstokens

1. Navigieren Sie zu Ihrer Azure DevOps-Organisation, und wählen Sie dann Benutzereinstellungen>Persönliche Zugriffstoken aus.

   

2. Erstellen Sie ein neues persönliches Zugriffstoken mit dem Bereich Packaging* >Read. Kopieren Sie Ihr PAT, da Sie es im folgenden Abschnitt benötigen werden.

3. Wählen Sie Erstellen, wenn Sie fertig sind.

   

Erstellen einer Dienstverbindung

1. Melden Sie sich bei der Azure DevOps-Organisation an, in der Ihre Pipeline ausgeführt wird, und navigieren Sie dann zu Ihrem Projekt.

2. Navigieren Sie zu den Project-Einstellungen>Dienstverbindungen.

3. Wählen Sie Neue Dienstverbindung und anschließend NuGet, dann Weiter aus.

4. Wählen Sie Externen Azure DevOps-Server als Authentifizierungsmethode aus, und geben Sie dann Ihre Zielfeed-URL ein. Fügen Sie das zuvor erstellte persönliche Zugriffstoken ein, geben Sie einen Namen für Ihre Dienstverbindung ein, und überprüfen Sie , ob für Ihr Szenario zutreffend, Zugriffsberechtigungen für alle Pipelines gewähren.

5. Wählen Sie Speichern aus, wenn Sie fertig sind.

   

Pakete wiederherstellen

YAML

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

2. Wählen Sie Pipelines und dann Ihre Pipelinedefinition aus.

3. Wählen Sie Bearbeiten aus, und fügen Sie dann der YAML-Pipeline den folgenden Codeausschnitt hinzu.

   - task: NuGetToolInstaller@1
     inputs:
       versionSpec: '*'
       checkLatest: true
   
   - task: NuGetAuthenticate@1
     inputs:
       nuGetServiceConnections: <SERVICE_CONNECTION_NAME>
   
   - script: nuget.exe restore <SOLUTION_PATH>      ## If you're using Ubuntu 24.04 or later, use the following command instead: dotnet restore <SOLUTION_PATH>   
   

Klassisch

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

2. Wählen Sie Pipelines, Ihre Pipelinedefinition und dann Bearbeiten aus.

3. Wählen Sie + aus, um eine neue Aufgabe hinzuzufügen. Fügen Sie der Pipelinedefinition die Aufgaben NuGet tool installer, NuGet Authenticate und Befehlszeile hinzu. Sie können für den NuGet tool installer die Standardeinstellungen beibehalten und die anderen Aufgaben folgendermaßen konfigurieren:

   1. NuGet Authenticate Aufgabe: Wählen Sie Ihre Dienst-Verbindung aus dem Dropdown-Menü Anmeldeinformationen für Dienst-Verbindungen für Feeds außerhalb dieser Organisation.

   2. Befehlszeilenaufgabe:

      • Anzeigename: Wiederherstellen.
      • Skript: nuget.exe restore <SOLUTION_PATH>. Wenn Sie Ubuntu 24.04 oder höher verwenden, verwenden Sie stattdessen den folgenden Befehl: dotnet restore <SOLUTION_PATH>

4. Wählen Sie Speichern & in Warteschlange einreihen aus, wenn Sie fertig sind.

Zugehöriger Inhalt

• Veröffentlichen von Paketen in internen und externen Feeds
• Veröffentlichen und Herunterladen von Pipeline-Artefakten
• Use the .artifactignore file