Démarrage avec des packages NuGet dans Azure Artifacts

Azure DevOps Services | Azure DevOps Server 2020 | 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. Les flux d’artefacts peuvent être privés pour partager vos packages avec votre équipe et des utilisateurs spécifiques, ou publics pour les partager publiquement avec n’importe qui sur Internet.

Cet article porte sur les points suivants :

  • Comment créer un flux
  • Comment configurer votre projet et vous connecter à votre flux
  • Comment publier des packages NuGet sur votre flux
  • Guide pratique pour télécharger NuGet packages à partir de votre flux

Prérequis

Créer un flux

Vous pouvez créer deux types de flux : les flux délimités par le projet et les flux d’étendue de l’organisation. Tous les flux publics sont étendus à leur projet d’hébergement et héritent de ses paramètres de visibilité.

  1. Sélectionnez Artifacts, puis sélectionnez Créer un flux.

    Create a feed button

  2. Donnez à votre flux un nom et choisissez sa visibilité (qui peut afficher les packages dans ce flux), les sources en amont et l’étendue ( étendue du projet ou étendue de l’organisation).

    New feed dialog box

  3. Lorsque vous avez terminé, sélectionnez Créer.

Azure Artifacts est installé par défaut pour les clients TFS 2017. Vous devez effectuer une mise à niveau vers TFS 2017 pour utiliser Azure Artifacts. Si c’est la première fois que vous utilisez votre flux, vous êtes peut-être invité à attribuer une licence

  1. Accédez à Build & Release et sélectionnez Packages.

    Go to Azure Artifacts TFS

  2. Sélectionnez + Nouveau flux.

    New feed button TFS

  3. Donnez à votre flux un nom, une description et configurez qui peut lire, qui peut contribuer et si vous souhaitez inclure des packages externes.

    New feed dialog box TFS

  4. Lorsque vous avez terminé, sélectionnez Créer.

Connecter à nourrir

  1. Dans votre projet, sélectionnez Artifacts, puis sélectionnez votre flux.

  2. Sélectionnez Se connecter au flux.

    Connect to your feed

  3. Sélectionnez NuGet.exe.

    NuGet.exe feed connection

  4. Si c’est la première fois que vous utilisez Azure Artifacts avec Nuget.exe, sélectionnez Obtenir les outils et suivez les instructions pour :

    1. Installez la dernière version NuGet.
    2. Installez Azure Artifacts fournisseur d’informations d’identification.
  5. Suivez les instructions de la configuration Project pour ajouter un fichier de .config nuget.

    Project setup

  1. Sélectionnez Build etReleasePackages>.

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

  3. Sélectionnez Se connecter au flux.

    Connect to feed - TFS

  4. Sélectionnez NuGet et suivez les instructions pour vous connecter à votre flux.

    Connect to NuGet feed - TFS

Publier des packages NuGet

Exécutez la commande suivante dans une fenêtre d’invite de commandes avec élévation de privilèges pour configurer votre fichier nuget.config et publier votre package NuGet dans votre flux. Pour plus d’informations, consultez les sources nuget et nuget Push :

nuget sources add -Name <SourceName> -Source <SourceURL> -username <UserName> -password <Pat>
nuget push -Source <SourceName> -ApiKey key <PackagePath>

Si vous n’avez pas de package NuGet, mais que vous souhaitez essayer de publier des packages dans votre flux, vous pouvez installer l’exemple de package HelloWorld comme suit :

nuget install HelloWorld -ExcludeVersion

Télécharger les packages NuGet

1. Obtenir l’URL source du flux

  1. Dans votre projet, sélectionnez Artifacts, puis sélectionnez votre flux.

  2. Sélectionnez Se connecter au flux.

    Connect to feed

  3. Sélectionnez Visual Studio dans la section NuGet .

  4. Copiez l’URL source de votre flux.

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

    Connect to feed

  4. Copiez l’URL source de votre flux.

    Copy source URL

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é des sources en amont dans votre flux, désactivez la case à cocher nuget.org .

  5. Sélectionnez OK.

    Set up visual studio: 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 . Select feed source
  3. Utilisez la barre de recherche pour rechercher des packages à partir de votre flux.