Prise en main des packages NuGet dans Azure Artifacts

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 telles que les flux et les registres publics. Avec Azure Artifacts, vous pouvez créer des flux qui peuvent être privés, ce qui vous permet de partager des packages avec votre équipe et des utilisateurs spécifiques, ou publics, ce qui vous permet de les partager publiquement avec n’importe qui sur Internet.

Dans cet article, vous allez apprendre à :

  • Créer un flux
  • Configurer votre projet et vous connecter à votre flux
  • Publier des packages NuGet
  • Télécharger des packages à partir de votre flux

Prérequis

Créer un flux

Azure Artifacts offre deux types de flux : les flux délimités par le projet et les flux d’étendue de l’organisation. si vous souhaitez créer un flux public, commencez par créer un flux dans l’étendue du projet, puis ajustez les paramètres de visibilité du projet hébergeant votre flux au public. Cela permettra de rendre votre flux étendu au projet accessible au public.

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

  2. Sélectionnez Artefacts, puis créez un flux pour créer un flux.

  3. Entrez un nom descriptif pour votre flux et définissez sa visibilité (indiquant qui peut afficher les packages dans le flux). Spécifiez l’étendue de votre flux et, si vous souhaitez inclure des packages à partir de sources publiques, marquez les sources en amont case activée box.

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

    Capture d’écran montrant comment créer un flux nécessaire.

Remarque

Par défaut, les flux nouvellement créés ont le service de génération de leur projet défini sur Feed and Upstream Reader (Collaborateur).

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 Se connecter au flux.

    Capture d’écran montrant le bouton Se connecter au flux.

  4. Sélectionnez NuGet.exe. S’il s’agit de la première utilisation d’Azure Artifacts avec Nuget.exe, vérifiez que vous avez installé tous les prérequis.

  5. Suivez les instructions fournies dans la section Configuration de Project pour configurer votre fichier nuget.config.

    Capture d’écran montrant comment configurer votre projet.

Télécharger des packages

1. Obtenir l’URL source du flux

  1. Accédez à votre projet, puis sélectionnez Artefacts , puis sélectionnez votre flux.

  2. Sélectionnez Connecter à alimenter, puis sélectionnez Visual Studio dans le volet de navigation gauche.

  3. Copiez votre URL source .

    Capture d’écran montrant l’URL source.

2. Configurer Visual Studio

  1. Dans Visual Studio, sélectionnez Outils, puis Options.

  2. Développez la section NuGet Gestionnaire de package, puis sélectionnez Sources de package.

  3. Entrez le nom du flux et l’URL source, puis sélectionnez le signe vert (+) pour ajouter une source.

  4. Si vous avez activé amont sources dans votre flux, désactivez la nuget.org case activée box.

  5. Sélectionnez OK lorsque vous avez terminé.

    Capture d’écran montrant comment configurer Visual Studio dans Windows.

3. Télécharger des packages

  1. Dans Visual Studio, cliquez avec le bouton droit sur votre projet, puis sélectionnez Gérer les packages NuGet.

  2. Sélectionnez Parcourir, puis sélectionnez votre flux dans le menu déroulant Source du package .

    Capture d’écran montrant comment sélectionner votre source de flux.

  3. Utilisez la barre de recherche pour rechercher des packages à partir de votre flux.

Remarque

L’utilisation de l’Explorateur de packages NuGet pour rechercher des packages dans amont s n’est pas prise en charge.

Publier des packages

Exécutez la commande suivante pour publier votre package sur votre flux. Vous pouvez utiliser n’importe quelle chaîne pour l’argument ApiKey .

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