Share via


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 naar uw feed
  • Pakketten installeren vanuit nuget.org

Vereisten

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 navigeer vervolgens naar uw project.

  2. Selecteer Artefacten en selecteer Vervolgens Feed maken om een nieuwe feed te maken.

  3. Voer een beschrijvende naam in voor uw feed en definieer de zichtbaarheid (waarmee wordt aangegeven wie pakketten in de feed kan bekijken). Geef het bereik van uw feed op en als u pakketten uit openbare bronnen wilt opnemen, schakelt u het selectievakje Upstream-bronnen in.

  4. Selecteer Maken wanneer u klaar bent.

    Een schermopname die laat zien hoe u een nieuwe feed maakt in Azure DevOps Services.

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

  2. Selecteer Artefacten en selecteer Vervolgens Feed maken om een nieuwe feed te maken.

  3. Voer een beschrijvende naam in voor uw feed en definieer de zichtbaarheid (waarmee wordt aangegeven wie pakketten in de feed kan bekijken). Geef het bereik van uw feed op en als u pakketten uit openbare bronnen wilt opnemen, schakelt u het selectievakje Upstream-bronnen in.

  1. Selecteer Maken wanneer u klaar bent.

    Een schermopname die laat zien hoe u een nieuwe feed maakt in Azure DevOps 2022.

  1. Selecteer Maken wanneer u klaar bent.

    Een schermopname van het maken van een nieuwe feed in Azure DevOps 2020.

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

  2. Selecteer Artefacten en selecteer vervolgens Nieuwe feed.

  3. Voer een beschrijvende naam in voor uw feed en definieer de zichtbaarheid (waarmee wordt aangegeven wie pakketten in de feed kan bekijken). Als u pakketten uit openbare bronnen wilt opnemen, selecteert u de optie Pakketten uit openbare bronnen gebruiken via deze feedoptie .

  4. Selecteer Maken wanneer u klaar bent.

    Een schermopname van het maken van een nieuwe feed in Azure DevOps 2019.

Notitie

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

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 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 Opslaan wanneer u klaar bent en selecteer Vervolgens Nog een keer opslaan in de rechterbovenhoek om uw wijzigingen op te slaan.

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

  2. Selecteer Artefacten en selecteer vervolgens uw feed.

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

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

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

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

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

  2. Selecteer Artefacten en selecteer vervolgens uw feed.

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

  4. Selecteer Upstream-bronnen en selecteer vervolgens Upstream-bron toevoegen.

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

  6. Selecteer Toevoegen wanneer u klaar bent.

Verbinding maken om 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 Verbinding maken om te voeren en selecteer 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>
      
  1. Meld u aan bij uw Azure DevOps-server en navigeer vervolgens naar uw project.

  2. Selecteer Artefacten en selecteer vervolgens uw feed.

  3. Selecteer Verbinding maken naar 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.

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

  2. Selecteer Artefacten en selecteer vervolgens uw feed.

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

  4. Volg de opgegeven instructies om uw pakketbron-URL toe te voegen aan uw nuget.config-bestand .

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.
  1. Meld u aan bij uw Azure DevOps-server en navigeer vervolgens naar uw project.
  1. Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.

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

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

    Een schermopname van het pakket dat is opgeslagen vanuit upstream.