Verwenden von Paketen aus dem NuGet-Katalog

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

Mit Azure Artifacts-Upstreamquellen können Entwickler Pakete aus öffentlichen Registrierungen wie nuget.org und npmjs.com nutzen. Dieser Artikel führt Sie durch den Prozess der Einrichtung Ihres Projekts und die Verwendung der Befehlszeile, um NuGet-Pakete aus dem NuGet-Katalog effektiv zu nutzen. In diesem Artikel lernen Sie Folgendes:

• Aktivieren von Upstreamquellen für Ihren Feed
• Hinzufügen des NuGet-Katalogs als Upstreamquelle
• Verbinden zu Ihrem Feed
• Installieren von Paketen aus nuget.org

Voraussetzungen

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

• Ein Azure Artifacts-Feed.

• Laden Sie NuGet herunter.

• Laden Sie den Azure Artifacts-Anmeldeinformationsanbieter herunter, und installieren Sie es.

Aktivieren von Upstreamquellen in Ihrem Feed

Wenn Sie keinen Feed haben, führen Sie die folgenden Schritte aus, um ein neues zu erstellen, und stellen Sie sicher, dass Sie das Kontrollkästchen für upstream-Quellen aktivieren, um sie zu aktivieren. Wenn Sie bereits über einen Feed verfügen, können Sie zum nächsten Schritt springen, um den NuGet-Katalog als upstream-Quelle hinzuzufügen.

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

2. Wählen Sie Artefakte und dann "Feed erstellen" aus, um einen neuen Feed zu erstellen.

3. Geben Sie einen beschreibenden Namen für Ihren Feed ein, und definieren Sie die Sichtbarkeit (die angibt, wer Pakete innerhalb des Feeds anzeigen kann). Geben Sie den Bereich Ihres Feeds an, und wenn Sie Pakete aus öffentlichen Quellen einschließen möchten, markieren Sie das Kontrollkästchen "Upstream-Quellen ".

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

   

Hinweis

Standardmäßig haben neu erstellte Feeds den Builddienst ihres Projekts auf Feed und Upstream Reader (Mitarbeiter) festgelegt.

Hinzufügen von NuGet-Katalog Upstream Quelle

Wenn Sie das Kontrollkästchen für upstream-Quellen beim Erstellen Ihres Feeds aktiviert haben, sollte der NuGet-Katalog automatisch hinzugefügt worden sein. Wenn nicht, fügen Sie sie manuell hinzu, indem Sie die folgenden Schritte ausführen:

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.

3. Wählen Sie die Zahnradsymbolschaltfläche aus, um zu Ihren Feedeinstellungen zu navigieren.

4. Wählen Sie "Upstreamquellen" und dann " Upstream hinzufügen" aus, um eine neue Upstreamquelle hinzuzufügen.

5. Wählen Sie "Öffentliche Quelle" und dann im Dropdownmenü "NuGet-Katalog " aus.

6. Wählen Sie "Speichern " aus, wenn Sie fertig sind, und wählen Sie dann "Speichern " in der oberen rechten Ecke aus, um Ihre Änderungen zu speichern.

Hinweis

Der Dienstindexspeicherort für nuget.org ist https://api.nuget.org/v3/index.json.

Verbindung mit 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 aus.

3. Wählen Sie Mit Feed verbinden und dann NuGet.exeaus.

4. Fügen Sie eine Nuget.config-Datei im selben Ordner wie Ihre CSPROJ - oder .sln-Datei hinzu. Fügen Sie den bereitgestellten XML-Codeausschnitt in Ihre Datei ein. Wenn Sie die folgenden Beispiele verwenden, stellen Sie sicher, dass Sie die Platzhalter durch die entsprechenden Werte für Ihr Szenario ersetzen.

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

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

Installieren von Paketen aus dem NuGet-Katalog

Mit unserem Projekt, das jetzt für die Authentifizierung mit unserem Feed konfiguriert ist, können wir jetzt mit der Installation von Paketen aus dem NuGet Gallery upstream fortfahren. In diesem Beispiel installieren wir die Serilog-Diagnoseprotokollierungsbibliothek :

1. Navigieren Sie zum NuGet-Katalog unter https://www.nuget.org/.

2. Suchen Sie nach dem Serilog-Paket , und wählen Sie es aus, um zur Detailseite zu navigieren.

3. Wählen Sie die Registerkarte Paket-Manager aus, und kopieren Sie den Befehl. In unserem Beispiel lautet der Befehl wie folgt:

   NuGet\Install-Package Serilog -Version 3.1.2-dev-02097
   

4. Öffnen Sie Ihr Projekt in Visual Studio, und wählen Sie dann "Tools>NuGet Paket-Manager> Paket-Manager Konsole aus, um das Konsolenfenster zu öffnen.

5. Fügen Sie ihren Befehl in das Fenster Paket-Manager Konsole ein, und drücken Sie die EINGABETASTE, um das Paket zu installieren.

Hinweis

Um Pakete vor dem Upstream zu speichern, müssen Sie über die Rolle " Feed" und "Upstream Reader" (Mitarbeiter) oder höher verfügen. Weitere Informationen finden Sie unter Berechtigungen.

Anzeigen gespeicherter Pakete

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 die NuGet Gallery-Quelle aus dem Dropdownmenü aus, um nach Paketen aus diesem Upstream zu filtern.

4. Das im vorherigen Schritt installierte Serilog-Paket ist jetzt in unserem Feed verfügbar. Azure Artifacts hat automatisch eine Kopie in unserem Feed gespeichert, wenn wir den Installationsbefehl ausgeführt haben.

   

Verwandte Artikel

• Veröffentlichen von NuGet-Paketen mit Azure Pipelines
• Veröffentlichen von Paketen in NuGet.org
• Verwalten von Berechtigungen