Verbinden zu Azure Artifacts-Feeds (NuGet.exe)

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

Azure Artifacts ermöglicht Entwicklern das Veröffentlichen und Herunterladen von NuGet-Paketen aus verschiedenen Quellen, einschließlich Feeds und öffentlichen Registrierungen. Sie können private Azure Artifacts-Feeds verwenden, um Pakete privat mit Ihrem Team oder bestimmten Benutzern zu teilen. Darüber hinaus können Sie öffentliche Feeds erstellen, um Pakete öffentlich zugänglich zu machen, sodass Sie sie offen für jeden im Internet freigeben können. Dieser Artikel führt Sie durch die Verbindung mit Ihrem Azure Artifacts-Feed.

Voraussetzungen

• Ein Azure DevOps-organization und ein Projekt. Erstellen Sie ein organization oder ein Projekt, falls noch nicht geschehen.

• Ein Azure Artifacts-Feed. Erstellen Sie einen neuen Feed, wenn Sie noch keinen haben.

• Installieren Sie die neueste NuGet-Version.

• Installieren Sie den Azure Artifacts-Anmeldeinformationsanbieter.

Projekteinrichtung

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 Verbinden zum Feed aus, und wählen Sie dann im linken Bereich NuGet.exe aus.

4. Wenn Sie Azure Artifacts zum ersten Mal mit NuGet.exe verwenden, stellen Sie sicher, dass Sie die erforderlichen Komponenten installiert haben, andernfalls wählen Sie "Tools in der oberen rechten Ecke abrufen" aus, um sie zu installieren.

5. Fügen Sie ihrem Projekt eine Nuget.config-Datei hinzu, platzieren Sie sie in demselben Ordner wie Ihre csproj - oder sln-Datei , und fügen Sie dann den bereitgestellten Codeausschnitt in ihn ein. Der Codeausschnitt sollte wie folgt strukturiert sein:

   • 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>
     

   • Feed mit Organisationsbereich:

     <?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>
     

Wichtig

Der Azure Artifacts-Anmeldeinformationsanbieter erfordert NuGet 4.8.0.5385 oder höher.

Um eine optimale Leistung zu erzielen, empfiehlt Azure Artifacts die Verwendung der NuGet-Version 5.5.x oder höher, da sie wichtige Fehlerbehebungen im Zusammenhang mit Abbrüchen und Timeouts enthält.

Legacyprojektsetup

Wenn Sie eine ältere Version von NuGet verwenden, folgen Sie den nachstehenden Anweisungen, um eine Verbindung mit Ihrem Feed herzustellen:

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 aus dem Dropdownmenü aus.

3. Wählen Sie Verbinden zum Feed aus, und wählen Sie dann im linken Bereich NuGet.exe aus.

4. Kopieren Sie die Quell-URL, und ersetzen Sie /v3/index.json sie durch /v2. Die aktualisierte Quell-URL sollte wie folgt aussehen:

   • Projektbezogener Feed:

     https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2
     

   • Feed mit Organisationsbereich:

     https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2
     

5. Erstellen Sie ein persönliches Zugriffstoken, und stellen Sie sicher, dass Sie den Bereich auf die richtige Organisation beschränken, auf die Sie zugreifen möchten, und wählen Sie einen der folgenden Bereiche aus: Verpackung (Lesen und Schreiben),Verpacken (Lesen und Schreiben) oder Verpacken (Lesen, Schreiben und Verwalten).

6. Führen Sie den folgenden Befehl in einem Eingabeaufforderungsfenster aus, um Ihre Feedquelle zur Datei "nuget.config " hinzuzufügen:

   nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <ANY_STRING_BUT_NOT_NULL> -password <YOUR_PERSONAL_ACCESS_TOKEN>
   

7. Wenn Ihre Organisation mit der Microsoft Entra-ID verbunden ist, müssen Sie sich zuerst mit Ihren AD-Anmeldeinformationen authentifizieren und dann Ihr persönliches Zugriffstoken mithilfe des Setapikey-Befehls hinzufügen:

   nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <AZURE_ACTIVE_DIRECTORY_USERNAME> -password <AZURE_ACTIVE_DIRECTORY_PASSWORD>
   
   nuget setapikey <YOUR_PERSONAL_ACCESS_TOKEN> -source <SOURCE_URL> 
   

Verwandte Artikel

• Veröffentlichen und Wiederherstellen von NuGet-Paketen (NuGet.exe)
• Veröffentlichen von NuGet-Paketen mit Azure Pipelines
• Verwenden von Paketen aus NuGet.org