Använda paket från NuGet-galleriet

  • Artikel

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

Med Uppströmskällor i Azure Artifacts kan utvecklare använda paket från offentliga register som nuget.org och npmjs.com. Den här artikeln beskriver hur du konfigurerar projektet och använder kommandoraden för att effektivt använda NuGet-paket från NuGet-galleriet. I den här artikeln får du lära dig att:

  • Aktivera överordnade källor för feeden
  • Lägg till NuGet-galleriet som en uppströmskälla
  • Anslut till ditt flöde
  • Installera paket från nuget.org

Förutsättningar

Aktivera överordnade källor i feeden

Om du inte har någon feed följer du dessa steg för att skapa en ny och se till att markera kryssrutan för överordnade källor för att aktivera dem. Om du redan har en feed kan du gå vidare till nästa steg för att lägga till NuGet-galleriet som en uppströmskälla.

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Artefakter och välj sedan Skapa feed för att skapa en ny feed.

  3. Ange ett beskrivande namn för feeden och definiera dess synlighet (som anger vem som kan visa paket i feeden). Ange omfånget för feeden och markera kryssrutan Överordnade källor om du vill inkludera paket från offentliga källor.

  4. Välj Skapa när du är klar.

    En skärmbild som visar hur du skapar en behovsfeed.

Kommentar

Som standard har nyskapade feeds projektets Build Service inställt på Feed och Upstream Reader (Kollaboratör).

Om du har markerat kryssrutan för överordnade källor när du skapade feeden bör NuGet-galleriet ha lagts till automatiskt. Om inte lägger du till det manuellt genom att följa dessa steg:

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Artefakter och välj sedan din feed.

  3. Välj kugghjulsikonen för kugghjulsikon att gå till feedinställningarna.

  4. Välj Överordnade källor och välj sedan Lägg till uppströms för att lägga till en ny uppströmskälla.

  5. Välj Offentlig källa och välj sedan NuGet-galleri på den nedrullningsbara menyn.

  6. Välj Spara när du är klar och välj sedan Spara en gång till i det övre högra hörnet för att spara ändringarna.

Kommentar

Tjänstindexplatsen för nuget.org är https://api.nuget.org/v3/index.json.

Anslut att mata

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Artefakter och välj sedan din feed.

  3. Välj Anslut som ska matas och välj sedan NuGet.exe.

  4. Lägg till en nuget.config-fil i samma mapp som filen .csproj eller .sln . Klistra in det angivna XML-kodfragmentet i filen. Om du använder exemplen nedan ska du ersätta platshållarna med lämpliga värden för ditt scenario.

    • Flöde med organisationsomfattning:

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

    • Flöde med projektomfattning:

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

Nu när vårt projekt har konfigurerats för att autentisera med vårt flöde kan vi nu fortsätta att installera paket från NuGet-galleriet uppströms. I det här exemplet installerar vi Serilog-biblioteket för diagnostikloggning:

  1. Gå till NuGet-galleriet på https://www.nuget.org/.

  2. Sök efter Serilog-paketet och välj det för att gå till informationssidan.

  3. Välj fliken Pakethanterare och kopiera kommandot. I vårt exempel är kommandot följande:

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

  4. Öppna projektet i Visual Studio och välj sedan Verktyg>NuGet Package Manager Package Manager>Console för att öppna konsolfönstret.

  5. Klistra in kommandot i fönstret Package Manager Console och tryck på Retur för att installera paketet.

Kommentar

Om du vill spara paket från uppströms måste du ha rollen Feed och Upstream Reader (Kollaboratör) eller högre. Mer information finns i Behörigheter.

Visa sparade paket

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Artefakter och välj sedan din feed från den nedrullningsbara menyn.

  3. Välj NuGet-gallerikällan på den nedrullningsbara menyn för att filtrera efter paket från den här överordnade menyn.

  4. Serilog-paketet, som installerades i föregående steg, är nu tillgängligt i vår feed. Azure Artifacts sparade automatiskt en kopia i vårt flöde när vi körde installationskommandot.

    En skärmbild som visar paketet som sparades från uppströms.