Pakketten uit NuGet Gallery gebruiken

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Met upstream-bronnen van Azure Artifacts kunnen ontwikkelaars pakketten van openbare registers gebruiken, zoals nuget.org en npmjs.com. In dit artikel wordt u begeleid bij het instellen van uw project en het gebruik van de opdrachtregel om NuGet-pakketten effectief te gebruiken vanuit de NuGet-galerie. In dit artikel leert u het volgende:

• Upstream-bronnen voor uw feed inschakelen
• NuGet Gallery toevoegen als een upstream-bron
• Verbinding maken met uw feed
• Pakketten installeren vanuit nuget.org

Vereisten

• Een Azure DevOps-organisatie en een project. Maak een organisatie of een project als u dat nog niet hebt gedaan.

• Een Azure Artifacts-feed.

• Download NuGet.

• Download en installeer azure Artifacts Credential Provider.

Upstream-bronnen inschakelen voor uw feed

Als u nog geen feed hebt gemaakt, volgt u de onderstaande stappen om een nieuwe feed te maken en controleert u of u het selectievakje upstream-bronnen inschakelt om deze in te schakelen. Als u al een feed hebt, gaat u verder met de volgende stap om de NuGet-galerie toe te voegen als een upstream-bron.

1. Meld u aan bij uw Azure DevOps-organisatie en ga vervolgens naar uw project.

2. Selecteer Artefacten en selecteer vervolgens Feed maken.

3. Voer voor Naam een beschrijvende naam in voor uw feed.

   Selecteer voor Zichtbaarheid een optie om aan te geven wie pakketten in de feed kan bekijken.

   Als u pakketten uit openbare bronnen wilt opnemen, schakelt u het selectievakje onder Upstream-bronnen in.

   Geef voor Bereik op of het bereik van uw feed het project of de organisatie is.

4. Selecteer Maken wanneer u klaar bent.

   

Notitie

Standaard is voor nieuw gemaakte feeds de buildservicewaarde van het project ingesteld op Feed en Upstream Reader (Samenwerker).

NuGet Gallery upstream-bron toevoegen

Als u het selectievakje upstream-bronnen hebt ingeschakeld bij het maken van uw feed, moet nuGet Gallery automatisch zijn toegevoegd. Als dat niet het probleem is, voegt u deze handmatig toe door de volgende stappen uit te voeren:

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

2. Selecteer Artefacten en selecteer vervolgens uw feed.

3. Selecteer de knop tandwielpictogram om naar uw feedinstellingen te navigeren.

4. Selecteer Upstream-bronnen en selecteer Vervolgens Upstream toevoegen om een nieuwe upstream-bron toe te voegen.

5. Selecteer openbare bron en selecteer vervolgens NuGet Gallery in de vervolgkeuzelijst.

6. Selecteer Toevoegen wanneer u klaar bent en selecteer nog een keer Opslaan in de rechterbovenhoek om uw wijzigingen op te slaan.

Verbinding maken met feed

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

2. Selecteer Artefacten en selecteer vervolgens uw feed.

3. Selecteer Verbinding maken met feed en selecteer vervolgens NuGet.exe.

4. Voeg een nuget.config-bestand toe in dezelfde map als uw .csproj - of .sln-bestand . Plak het opgegeven XML-fragment in het bestand. Als u de onderstaande voorbeelden gebruikt, moet u ervoor zorgen dat u de tijdelijke aanduidingen vervangt door de juiste waarden voor uw scenario.

   • Feed met organisatiebereik:

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

   • Feed met projectbereik:

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

Pakketten installeren vanuit NuGet Gallery

Nu ons project is geconfigureerd voor verificatie met onze feed, kunnen we nu doorgaan met het installeren van pakketten vanuit de NuGet Gallery upstream. In dit voorbeeld installeren we de bibliotheek voor diagnostische logboekregistratie van Serilog :

1. Navigeer naar de NuGet Gallery op https://www.nuget.org/.

2. Zoek het Serilog-pakket en selecteer het om naar de detailpagina te navigeren.

3. Selecteer het tabblad Pakketbeheer en kopieer de opdracht. In ons voorbeeld is de opdracht als volgt:

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

4. Open uw project in Visual Studio en selecteer vervolgens Tools>NuGet Pakketbeheer> Pakketbeheer Console om het consolevenster te openen.

5. Plak de opdracht in het venster Pakketbeheer Console en druk op Enter om het pakket te installeren.

Notitie

Als u pakketten wilt opslaan vanuit upstreams, moet u de rol Feed en Upstream Reader (Samenwerker) of hoger hebben. Zie Machtigingen beheren voor meer informatie.

Opgeslagen pakketten weergeven

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

2. Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.

3. Selecteer de NuGet Gallery-bron in de vervolgkeuzelijst om te filteren op pakketten uit deze upstream.

4. Het Serilog-pakket , geïnstalleerd in de vorige stap, is nu beschikbaar in onze feed. Azure Artifacts heeft automatisch een kopie opgeslagen in onze feed toen we de installatieopdracht uitvoerden.

   

Verwante artikelen:

• NuGet-pakketten publiceren met Azure Pipelines
• Pakketten publiceren naar NuGet.org
• Machtigingen beheren