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
• Ansluta till din feed
• 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 gå sedan till projektet.

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

3. Som Namn anger du ett beskrivande namn för feeden.

   För Synlighet väljer du ett alternativ för att ange vem som kan visa paket i flödet.

   Om du vill inkludera paket från offentliga källor markerar du kryssrutan under Överordnade källor.

   För Omfång anger du om omfånget för ditt flöde är projektet eller organisationen.

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

   

Kommentar

Som standard har nyligen skapade feeds projektets build service-värde 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 Lägg till 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.

Ansluta till feed

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 till feed 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