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

  • Article

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

Azure Artifacts vous permet de publier et de restaurer vos packages NuGet vers et à partir de votre flux, ce qui vous permet de les partager avec d’autres personnes en fonction des paramètres de visibilité de votre flux. Ce guide vous guide tout au long de la configuration de votre projet pour publier ou restaurer des packages à l’aide de l’interface de ligne de commande dotnet.

Prérequis

Se connecter au flux

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

  2. Sélectionnez Connecter à alimenter, puis sélectionnez dotnet dans la section NuGet à gauche.

  3. Créez un fichier nuget.config dans le même dossier que votre fichier csproj ou sln . Copiez l’extrait de code XML suivant et collez-le dans votre nouveau fichier, en remplaçant les espaces réservés par les informations pertinentes :

  • Flux à l'échelle de l'organisation :

    <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
  </packageSources>
</configuration>

  • Flux à l'échelle du projet :

    <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
  </packageSources>
</configuration>

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

  2. Sélectionnez Artefacts, puis sélectionnez votre flux.

  3. Sélectionnez Connecter de flux, puis sélectionnez dotnet dans le volet de navigation gauche.

  4. Suivez les instructions de la section Configuration de Project pour vous connecter à votre flux.

    Capture d’écran montrant comment se connecter à un flux avec dotnet dans Azure DevOps Server 2020 et 2022.

Remarque

dotnet n’est pas pris en charge dans Azure DevOps Server 2019.

Publier des packages

Exécutez la commande suivante pour publier un package sur votre flux. Remplacez les espaces réservés par les informations appropriées :

dotnet nuget push --source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --api-key <ANY_STRING> <PACKAGE_PATH>

Exemple : dotnet nuget push --source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --api-key AZ bin/MyPackage.5.0.2.nupkg

Remarque

Il api-key est utilisé uniquement comme espace réservé.

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. Remplacez l’espace <>réservé PERSONAL_ACCESS_TOKEN par votre jeton d’accès personnel, puis exécutez la commande suivante pour ajouter votre source de package à votre fichier nuget.config. Cela ajoute votre PAT à votre fichier nuget.config. Veillez à stocker ce fichier en toute sécurité et ne pas l’case activée dans le contrôle de code source.

    dotnet nuget add source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --name <SOURCE_NAME> --username <USER_NAME> --password <PERSONAL_ACCESS_TOKEN> --configfile <PATH_TO_NUGET_CONFIG_FILE>

  3. Publiez votre package :

    dotnet nuget push --source <SOURCE_NAME> --api-key <ANY_STRING> <PACKAGE_PATH>

Exemple : dotnet nuget add source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --name MySource --username MyUserName --password MyPersonalAccessToken --configfile ./nuget.configdotnet nuget push --source MySource --api-key AZ nupkgs/mypackage.1.1.0.nupkg

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 pour restaurer vos packages. L’indicateur --interactive est utilisé pour inviter l’utilisateur à entrer des informations d’identification :

dotnet restore --interactive