Partager via


Publier et télécharger des packages NuGet avec Azure Artifacts

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Azure Artifacts permet aux développeurs de publier et de télécharger des packages NuGet à partir de flux ou de registres publics. Les flux peuvent être privés, ce qui vous permet de partager des packages avec des utilisateurs spécifiques ou publics, ce qui rend vos packages accessibles à toute personne sur Internet.

Cet article vous guide tout au long de la création d’un flux, de la configuration de votre projet et de la publication et du téléchargement de packages NuGet.

Prerequisites

Produit Exigences
Azure DevOps - Une organisation Azure DevOps .
- Un projet Azure DevOps .
- Téléchargez et installez le fournisseur d'identifiants Azure Artifacts .
- Installez la dernière version de NuGet.

Créer un flux

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

  2. Sélectionnez Artifacts, puis sélectionnez Create feed.

  3. Fournissez un nom pour votre flux, choisissez l’option Visibilité qui définit qui peut afficher vos packages, cochez Inclure des packages à partir de sources publiques courantes si vous souhaitez inclure des packages à partir de sources telles que nuget.org ou npmjs.com, et pour étendue, déterminez si le flux doit être étendu à votre projet ou à l’ensemble de l’organisation.

  4. Sélectionnez Créer lorsque vous avez terminé.

    Capture d'écran montrant les sélections pour la création d'un nouveau flux dans Azure DevOps Services.

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

  2. Sélectionnez Artifacts, puis sélectionnez Create feed.

  3. Fournissez un nom pour votre flux, choisissez l’option Visibilité qui définit qui peut afficher vos packages, cochez Inclure des packages à partir de sources publiques courantes si vous souhaitez inclure des packages à partir de sources telles que nuget.org ou npmjs.com, et pour étendue, déterminez si le flux doit être étendu à votre projet ou à l’ensemble de l’organisation.

  1. Sélectionnez Créer lorsque vous avez terminé.

    Capture d'écran montrant les sélections pour la création d'un nouveau flux dans Azure DevOps 2022.

  1. Sélectionnez Créer lorsque vous avez terminé.

    Capture d'écran montrant les sélections pour la création d'un nouveau flux dans Azure DevOps 2020.

Note

Par défaut, le service de build pour le projet (par exemple : projectName Build Service (orgName)) est affecté au rôle Flux et Lecteur en amont (Collaborateur) lorsqu’un flux est créé.

Se connecter à un 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 Se connecter au flux, puis sélectionnez NuGet.exe dans le volet de navigation gauche. S’il s’agit de votre première utilisation d’Azure Artifacts avec Nuget.exe, vérifiez que vous avez installé les prérequis.

  4. Suivez les instructions fournies sous la section Configuration de Project pour configurer votre fichier nuget.config et vous connecter à votre flux Azure Artifacts.

    Capture d’écran montrant comment configurer votre projet et vous connecter à votre flux dans Azure DevOps Services.

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

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

  3. Sélectionnez Se connecter au flux, puis sélectionnez NuGet.exe dans le volet de navigation gauche.

  4. Suivez les instructions fournies sous la section Configuration de Project pour configurer votre fichier nuget.config et vous connecter à votre flux Azure Artifacts.

    Capture d’écran montrant comment configurer votre projet et vous connecter à votre flux dans Azure DevOps Server 2020 et 2022.

Publier des packages dans votre flux

Pour publier un package dans votre flux, exécutez la commande suivante. Le ApiKey paramètre est obligatoire, mais vous pouvez utiliser n’importe quelle chaîne arbitraire comme valeur.

nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>

Exemples

  • Flux à l'échelle du projet :

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    
  • Flux à l'échelle de l'organisation :

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/_packaging/myFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    

Note

Le ApiKey est obligatoire, mais vous pouvez utiliser n’importe quelle valeur arbitraire lors de la publication sur les flux Azure Artifacts.

Télécharger des packages à partir de votre flux

Pour restaurer des packages à partir de votre flux, exécutez la commande suivante dans le répertoire de votre projet :

nuget.exe restore

Note

La recherche de packages dans des sources en amont à l’aide de l’Explorateur de packages NuGet n’est pas prise en charge.