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

Aktivieren von Upstreamquellen in Ihrem Feed

Wenn Sie noch keinen Feed erstellt 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, fahren Sie mit dem nächsten Schritt fort, 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.

    Screenshot, der zeigt, wie Sie einen neuen Feed in Azure DevOps Services erstellen.

  1. Melden Sie sich bei Ihrem Azure DevOps-Server 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 ".

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

    Screenshot, der zeigt, wie Sie einen neuen Feed in Azure DevOps 2022 erstellen.

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

    Screenshot, der zeigt, wie Sie einen neuen Feed in Azure DevOps 2020 erstellen.

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

  2. Wählen Sie Artefakte und dann " Neuer Feed" aus.

  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). Wenn Sie Pakete aus öffentlichen Quellen einschließen möchten, wählen Sie die Option "Pakete aus öffentlichen Quellen verwenden" aus.

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

    Screenshot, der zeigt, wie Sie einen neuen Feed in Azure DevOps 2019 erstellen.

Hinweis

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

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 zahnradsymbol 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.

  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 die Zahnradsymbolschaltfläche Zahnradsymbolschaltfläche Zahnradsymbol aus aus, um zu Ihren Feedeinstellungen zu navigieren.

  4. Wählen Sie Upstreamquellen und dann Upstream hinzufügen aus.

  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.

  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 die Zahnradsymbolschaltfläche zahnradsymbol aus, um zu Ihren Feedeinstellungen zu navigieren.

  4. Wählen Sie "Upstreamquellen" und dann " Upstreamquelle hinzufügen" aus.

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

  6. Wenn Sie fertig sind, wählen Sie Hinzufügen aus.

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

  4. Folgen Sie den Anweisungen im Abschnitt "Project-Setup ", um eine Verbindung mit Ihrem Feed herzustellen.

  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 zu Feed aus, und wählen Sie dann "NuGet" im linken Navigationsbereich aus.

  4. Folgen Sie den bereitgestellten Anweisungen, um Ihre Paketquell-URL zur Datei "nuget.config " hinzuzufügen.

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 verwalten" .

Anzeigen gespeicherter Pakete

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.
  1. Melden Sie sich bei Ihrem Azure DevOps-Server an, und navigieren Sie dann zu Ihrem Projekt.
  1. Wählen Sie Artefakte und dann Ihren Feed im Dropdownmenü aus.

  2. Wählen Sie die NuGet Gallery-Quelle aus dem Dropdownmenü aus, um nach Paketen aus diesem Upstream zu filtern.

  3. 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.

    Screenshot des Pakets, das aus dem Upstream gespeichert wurde.