Connecter aux flux Azure Artifacts (NuGet.exe)

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

Azure Artifacts permet aux développeurs de publier et de télécharger des packages NuGet à partir de différentes sources, notamment des flux et des registres publics. Vous pouvez utiliser des flux Azure Artifacts privés pour partager des packages en privé avec votre équipe ou des utilisateurs spécifiques. En outre, vous pouvez créer des flux publics pour rendre les packages accessibles publiquement, ce qui vous permet de les partager publiquement avec n’importe qui sur Internet. Cet article vous guide tout au long de la connexion à votre flux Azure Artifacts.

Prérequis

• Un organization Azure DevOps et un projet. Créez un organization ou un projet si ce n’est pas déjà fait.

• Un flux Azure Artifacts. Créez un flux si vous n’en avez pas déjà.

• Installez la dernière version de NuGet.

• Installez le fournisseur d’informations d’identification Azure Artifacts.

Configuration du projet

1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

2. Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant.

3. Sélectionnez Connecter à alimenter, puis sélectionnez NuGet.exe dans le volet gauche.

4. S’il s’agit de votre première utilisation d’Azure Artifacts avec NuGet.exe, vérifiez que vous avez installé les prérequis, sinon sélectionnez Obtenir les outils dans le coin supérieur droit pour les installer.

5. Ajoutez un fichier nuget.config à votre projet, placez-le dans le même dossier que votre fichier csproj ou sln , puis collez l’extrait de code fourni dans celui-ci. L’extrait de code doit être structuré comme suit :

   • Flux dans l’étendue du projet :

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

   • Flux d’étendue de l’organisation :

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

Important

Le fournisseur d’informations d’identification Azure Artifacts nécessite NuGet 4.8.0.5385 ou une version ultérieure.

Pour des performances optimales, Azure Artifacts recommande d’utiliser la version de NuGet ou une version 5.5.x ultérieure, car il inclut des correctifs de bogues essentiels liés aux annulations et aux délais d’expiration.

Configuration du projet hérité

Si vous utilisez une version antérieure de NuGet, suivez les instructions ci-dessous pour vous connecter à votre flux :

1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

2. Sélectionnez Artefacts , puis sélectionnez votre flux dans le menu déroulant.

3. Sélectionnez Connecter à alimenter, puis sélectionnez NuGet.exe dans le volet gauche.

4. Copiez votre URL source, puis remplacez /v3/index.json par /v2. Votre URL source mise à jour doit ressembler à ce qui suit :

   • Flux dans l’étendue du projet :

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

   • Flux d’étendue de l’organisation :

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

5. Créez un jeton d’accès personnel et veillez à l’étendre à la bonne organisation à laquelle vous souhaitez accéder et sélectionnez l’une des étendues suivantes : Empaquetage (lecture), Empaquetage (lecture et écriture) ou Empaquetage (lecture, écriture et gestion).

6. Exécutez la commande suivante dans une fenêtre d’invite de commandes pour ajouter votre source de flux à votre fichier nuget.config :

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

7. Si votre organisation est connectée à l’ID Microsoft Entra, vous devez d’abord vous authentifier avec vos informations d’identification AD, puis ajouter votre jeton d’accès personnel à l’aide de la commande setapikey :

   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> 
   

Articles connexes

• Publier et restaurer des packages NuGet (NuGet.exe)
• Publier des packages NuGet avec Azure Pipelines
• Utiliser des packages à partir de NuGet.org