Dela via


Använda paket från NuGet-galleriet

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 skapat en feed ännu följer du stegen nedan för att skapa en ny och se till att du markerar kryssrutan överordnade källor för att aktivera dem. Om du redan har en feed går du 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 ny feed i Azure DevOps Services.

  1. Logga in på Din Azure DevOps-server 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.

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

    En skärmbild som visar hur du skapar en ny feed i Azure DevOps 2022.

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

    En skärmbild som visar hur du skapar en ny feed i Azure DevOps 2020.

  1. Logga in på Din Azure DevOps-server och navigera sedan till projektet.

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

  3. Ange ett beskrivande namn för feeden och definiera dess synlighet (som anger vem som kan visa paket i feeden). Om du vill inkludera paket från offentliga källor väljer du alternativet Använd paket från offentliga källor via den här feeden .

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

    En skärmbild som visar hur du skapar en ny feed i Azure DevOps 2019.

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.

  1. Logga in på Din Azure DevOps-server 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.

  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.

  1. Logga in på Din Azure DevOps-server 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ömskälla.

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

  6. Välj Lägg till när du är klar.

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>
      
  1. Logga in på Din Azure DevOps-server och navigera sedan till projektet.

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

  3. Välj Anslut till Feed och välj sedan NuGet.exe i det vänstra navigeringsfönstret.

  4. Följ anvisningarna i avsnittet Project setup (Projektkonfiguration) för att ansluta till feeden.

  1. Logga in på Din Azure DevOps-server och navigera sedan till projektet.

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

  3. Välj Anslut till Feed och välj sedan NuGet i det vänstra navigeringsfönstret.

  4. Följ de angivna anvisningarna för att lägga till paketkällans URL i nuget.config-filen .

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 Hantera behörigheter .

Visa sparade paket

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.
  1. Logga in på Din Azure DevOps-server och navigera sedan till projektet.
  1. Välj Artefakter och välj sedan din feed från den nedrullningsbara menyn.

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

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