Delen via


Pakketten uit de NuGet Gallery gebruiken

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Met upstream-bronnen van Azure Artifacts kunnen ontwikkelaars eenvoudig pakketten ophalen uit openbare registers, zoals nuget.org en npmjs.com. In dit artikel leert u hoe u uw project instelt en de opdrachtregel gebruikt om NuGet-pakketten te gebruiken vanuit de NuGet-galerie.

Vereisten

Product Requirements
Azure DevOps - Een Azure DevOps organisatie.
- Een Azure DevOps--project.
- Een Azure Artifacts feed.
- Download en installeer vervolgens de Azure Artifacts Credential Provider.
- Installeer de nieuwste NuGet-versie.

Een feed maken en upstream-bronnen inschakelen

Als u nog geen feed hebt gemaakt, volgt u de onderstaande stappen om een nieuwe feed te maken en upstream-bronnen 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 navigeer naar uw project.

  2. Selecteer Artefacten en klik vervolgens op Feed maken.

  3. Geef een naam op voor uw feed, selecteer de optie Zichtbaarheid om te definiëren wie uw pakketten kan bekijken en kies uw bereik. Azure Artifacts raadt aan om feeds te beperken tot een project in plaats van tot de hele organisatie.

  4. Zorg ervoor dat u de optie Pakketten opnemen uit algemene openbare bronnen controleert, omdat u dit nodig hebt om pakketten van openbare registers te gebruiken, zoals nuget.org, npmjs.com enzovoort.

  5. Selecteer Maken wanneer u klaar bent.

    Een schermopname van het maken van een nieuwe feed en het inschakelen van upstream-bronnen in Azure Artifacts.

Als u het selectievakje Upstream-bronnen hebt ingeschakeld bij het maken van uw feed (zoals weergegeven in de vorige sectie), moet de NuGet-galerie automatisch zijn toegevoegd aan de upstream-bronnen van uw feed. Als u met een andere feed werkt of bent vergeten deze optie te controleren, kunt u de NuGet-galerie handmatig toevoegen door de volgende stappen uit te voeren:

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

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

  3. Selecteer het tandwielpictogram om naar uw feedinstellingen te navigeren.

  1. Selecteer Upstream-bronnen en selecteer Vervolgens Upstream toevoegen.

  2. Selecteer Openbare bron, selecteer NuGet Gallery in de vervolgkeuzelijst en selecteer vervolgens Toevoegen.

  3. Selecteer Opslaan in de rechterbovenhoek en selecteer Opnieuw opslaan om uw wijzigingen te bevestigen en toe te passen.

Verbinding maken met uw feed

In deze sectie leert u hoe u uw project instelt voor verificatie met uw Azure Artifacts-feed en pakketten opslaat uit upstream-bronnen, zoals de NuGet-galerie.

  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 Verbinding maken met feed en selecteer vervolgens NuGet.exe.

  4. Zorg ervoor dat u de vereisten hebt geïnstalleerd en voeg vervolgens een nuget.config bestand toe in dezelfde map als uw .csproj - of .sln-bestand .

  5. Plak het XML-fragment dat is opgegeven in de sectie Project-installatie in uw bestand. Het bestand moet er ongeveer als volgt uitzien:

    • Projectspecifieke feed

      <?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>
      
    • 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>
      
  1. Meld u aan bij uw Azure DevOps-verzameling en navigeer vervolgens naar uw project.

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

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

  4. Volg de instructies in de sectie Project-installatie om verbinding te maken met uw feed.

Nu uw project is geconfigureerd voor verificatie met uw Azure Artifacts-feed, kunt u doorgaan met het installeren van pakketten vanuit de NuGet Gallery upstream. In dit voorbeeld installeert u de MCP C#SDK voor het Model Context Protocol voor .NET-toepassingen om te communiceren met MCP-clients en -servers:

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

  2. Zoek het ModelContextProtocol en selecteer deze om de detailpagina te openen.

  3. Selecteer het tabblad .NET CLI en kopieer de opdracht. In dit voorbeeld is de opdracht:

    dotnet add package ModelContextProtocol --version 0.3.0-preview.4
    
  4. Open een opdrachtpromptvenster, navigeer naar de projectmap, plak de opdracht en druk op Enter om het pakket te installeren.

Zodra het pakket is geïnstalleerd, wordt er automatisch een kopie van het pakket opgeslagen in uw feed, waardoor de beschikbaarheid wordt gegarandeerd als de NuGet Gallery niet beschikbaar is en uw werkstroom beveiligt tegen andere beschadigde of schadelijke pakketten uit het openbare register.

Notitie

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

Opgeslagen pakketten weergeven

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

  2. Selecteer Artefactenen 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. De ModelContextProtocol-pakketten , geïnstalleerd in de vorige stap, zijn nu beschikbaar in onze feed. Azure Artifacts heeft automatisch een kopie opgeslagen in uw feed.

    Een schermopname van het MCP-pakket dat is opgeslagen in de feed.