Prise en main des packages NuGet dans Azure Artifacts

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

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

    A screenshot showing how to create a need feed.

Remarque

Par défaut, les flux nouvellement créés ont le service de build de leur projet défini sur Collaborateur.

Azure Artifacts est préinstallé dans TFS 2018. S’il s’agit de votre première utilisation de votre flux, vous serez peut-être invité à attribuer une licence.

  1. Accédez à votre projet http://ServerName:8080/tfs/DefaultCollection/<ProjectName>.

  2. Sélectionnez Build &Release, puis sélectionnez Packages.

  3. Sélectionnez + Nouveau flux pour créer un flux.

  4. Fournissez un nom et une description explicites pour votre flux. Spécifiez les autorisations pour qui peut lire et qui peut contribuer et décider s’il faut inclure des packages externes.

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

    A screenshot showing how to create a new feed in TFS 2018.

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.

    A screenshot showing the connect to feed button.

  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.

    A screenshot showing how to set up your project.

  1. Accédez à votre projet http://ServerName:8080/tfs/DefaultCollection/<ProjectName>.

  2. Sélectionnez Générer et libérer>des packages.

  3. Sélectionnez votre flux dans le menu déroulant.

  4. Sélectionnez Se connecter au flux.

    A screenshot showing the connect to feed button in TFS.

  5. Sélectionnez NuGet, puis suivez les instructions pour vous connecter à votre flux.

    A screenshot showing how to connect to your feed in TFS.

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 .

    A screenshot showing the source URL.

  1. Sélectionnez Build et Release, puis sélectionnez Packages.

  2. Sélectionnez votre flux dans le menu déroulant.

  3. Sélectionnez Connecter à alimenter, puis copiez votre URL source.

    A screenshot showing the package source URL in TFS.

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

    A screenshot showing how to set up visual studio in 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 .

    A screenshot showing how to select your feed source.

  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>