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

• En Azure DevOps-organisation och ett projekt. Skapa en organisation eller ett projekt om du inte redan har gjort det.

• En Azure Artifacts-feed.

• Ladda ned NuGet.

• Ladda ned och installera Azure Artifacts Credential Provider.

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.

   

Kommentar

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

Lägg till NuGet-galleriets överordnade källa

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

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>
     

Installera paket från NuGet-galleriet

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.

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.

   

Relaterade artiklar

• Publicera NuGet-paket med Azure Pipelines
• Publicera paket till NuGet.org
• Hantera behörigheter