Publier et restaurer des packages NuGet à partir de la ligne de commande (NuGet.exe)

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

Avec Azure Artifacts, vous pouvez publier vos packages NuGet sur des flux publics et privés, ce qui vous permet de les partager avec d’autres utilisateurs en fonction des paramètres de visibilité de votre flux. Cet article vous guide tout au long de la connexion à votre flux Azure Artifacts et à la publication et à la restauration de vos packages NuGet.

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

• Fournisseur d’informations d’identification Azure Artifacts.

• Dernière version de NuGet.

Se connecter au 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 de navigation gauche.

4. Ajoutez un fichier nuget.config à votre projet, dans le même dossier que votre fichier .csproj ou .sln . Collez l’extrait de code XML fourni dans votre fichier. L’extrait de code doit ressembler à ce qui suit :

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

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

Publier des packages

Exécutez la commande suivante pour publier vos packages dans votre flux. Remplacez les espaces réservés par les informations pertinentes :

nuget push <PACKAGE_PATH> -src https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json -ApiKey <ANY_STRING>

Exemple :

nuget push MyPackage.5.0.2.nupkg -src https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ

Remarque

Le ApiKey est obligatoire, mais vous pouvez utiliser n’importe quelle valeur arbitraire lors de l’envoi à des flux Azure Artifacts.

Publier des packages à partir de sources externes

1. Créez un jeton d’accès personnel (PAT) avec l’empaquetage de l’étendue de lecture et d’écriture.

2. Ajoutez votre source de package à votre fichier nuget.config . Cela ajoute votre PAT à votre fichier nuget.config . Stockez ce fichier dans un emplacement sûr et assurez-vous que vous ne l’case activée pas dans le contrôle de code source.

   nuget sources Add -Name <SOURCE_NAME> -Source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json -UserName <USER_NAME> -Password <PERSONAL_ACCESS_TOKEN> -config <PATH_TO_NUGET_CONFIG_FILE>
   

3. Publiez votre package NuGet sur votre flux :

   nuget push <PACKAGE_PATH> -src <SOURCE_NAME> -ApiKey <ANY_STRING>
   

Exemple :

nuget sources Add -Name "MySource" -Source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json -UserName MyUserName -Password YourPersonalAccessToken -config ./nuget.config
nuget push nupkgs/mypackage.1.1.8.nupkg -src MySource -ApiKey AZ

Remarque

Si votre organisation utilise un pare-feu ou un serveur proxy, veillez à autoriser les URL et adresses IP du domaine Azure Artifacts.

Restaurer des packages

Exécutez la commande suivante dans le répertoire de votre projet pour restaurer vos packages :

nuget.exe restore

Articles connexes

• Utiliser des packages à partir de NuGet.org
• Publier des packages sur NuGet.org
• Publier des packages NuGet avec Azure Pipelines