Verbinding maken naar Azure Artifacts-feeds (NuGet.exe)

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

Met Azure Artifacts kunnen ontwikkelaars NuGet-pakketten publiceren en downloaden uit verschillende bronnen, waaronder feeds en openbare registers. U kunt persoonlijke Azure Artifacts-feeds gebruiken om pakketten privé te delen met uw team of specifieke gebruikers. Daarnaast kunt u openbare feeds maken om pakketten openbaar toegankelijk te maken, zodat u ze open kunt delen met iedereen op internet. Dit artikel helpt u bij het maken van verbinding met uw Azure Artifacts-feed.

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. Maak een nieuwe feed als u er nog geen hebt.

• Installeer de nieuwste NuGet-versie.

• Installeer de Referentieprovider van Azure Artifacts.

Projectinstellingen

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 om te voeren en selecteer vervolgens NuGet.exe in het linkerdeelvenster.

4. Als dit de eerste keer is dat u Azure Artifacts gebruikt met NuGet.exe, controleert u of u de vereisten hebt geïnstalleerd. Selecteer anders de hulpmiddelen in de rechterbovenhoek om ze te installeren.

5. Voeg een nuget.config-bestand toe aan uw project, plaats het in dezelfde map als uw csproj - of sln-bestand en plak het opgegeven fragment erin. Het codefragment moet als volgt zijn gestructureerd:

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

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

Belangrijk

Voor de Referentieprovider van Azure Artifacts is NuGet 4.8.0.5385 of hoger vereist.

Voor optimale prestaties raadt Azure Artifacts aan om nuGet-versie 5.5.x of hoger te gebruiken, omdat het cruciale bugfixes bevat met betrekking tot annuleringen en time-outs.

Verouderde projectinstallatie

Als u een oudere versie van NuGet gebruikt, volgt u de onderstaande instructies om verbinding te maken met uw feed:

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 om te voeren en selecteer vervolgens NuGet.exe in het linkerdeelvenster.

4. Kopieer de bron-URL en vervang deze door /v3/index.json /v2. De bijgewerkte bron-URL moet er ongeveer als volgt uitzien:

   • Feed met projectbereik:

     https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2
     

   • Feed met organisatiebereik:

     https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2
     

5. Maak een persoonlijk toegangstoken en zorg ervoor dat u het bereik van het token beperkt tot de juiste organisatie die u wilt openen en selecteer een van de volgende bereiken: Verpakking (lezen), Verpakking (lezen en schrijven) of Verpakking (lezen, schrijven en beheren).

6. Voer de volgende opdracht uit in een opdrachtpromptvenster om uw feedbron toe te voegen aan uw nuget.config-bestand :

   nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <ANY_STRING_BUT_NOT_NULL> -password <YOUR_PERSONAL_ACCESS_TOKEN>
   

7. Als uw organisatie is verbonden met Microsoft Entra ID, moet u zich eerst verifiëren met uw AD-referenties en vervolgens uw persoonlijke toegangstoken toevoegen met behulp van de setapikey-opdracht :

   nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <AZURE_ACTIVE_DIRECTORY_USERNAME> -password <AZURE_ACTIVE_DIRECTORY_PASSWORD>
   
   nuget setapikey <YOUR_PERSONAL_ACCESS_TOKEN> -source <SOURCE_URL> 
   

Verwante artikelen:

• NuGet-pakketten publiceren en herstellen (NuGet.exe)
• NuGet-pakketten publiceren met Azure Pipelines
• Pakketten uit NuGet.org gebruiken