Démarrage rapide : 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 sources telles que des flux et des registres publics. Avec Azure Artifacts, vous pouvez créer des flux qui sont les suivants :

• Privé, vous pouvez donc partager des packages avec votre équipe et des utilisateurs spécifiques.
• Public, vous pouvez donc partager des packages de manière ouverte avec n’importe qui sur Internet.

Dans ce guide de démarrage rapide, vous apprenez à :

• Créez un flux.
• Configurez votre projet et connectez-vous à votre flux.
• Publiez des packages NuGet.
• Téléchargez des packages à partir de votre flux.

Prérequis

• Créez une Organisation Azure DevOps et un Projet si ce n’est pas déjà fait.

• Installez la dernière version de NuGet.

• Installez le fournisseur d’informations d’identification Azure Artifacts.

Créer un flux

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

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

3. Pour Nom, entrez un nom descriptif pour votre flux.

   Pour visibilité, sélectionnez une option pour indiquer qui peut afficher les packages dans le flux.

   Si vous souhaitez inclure des packages à partir de sources publiques, cochez la case sous Sources en amont.

   Pour Étendue, spécifiez si l’étendue de votre flux est le projet ou l’organisation.

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

   

Remarque

Par défaut, les flux nouvellement créés ont la valeur du service de build de leur projet définie sur Feed and Upstream Reader (Collaborateur).

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 gauche. S’il s’agit de votre première utilisation d’Azure Artifacts avec Nuget.exe, vérifiez que vous avez installé tous les prérequis.

   

4. Suivez les instructions de la section configuration de Project pour configurer votre fichier nuget.config et vous authentifier auprès d’Azure Artifacts.

   

Télécharger des packages

1. Obtenir l’URL source du package

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

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

3. Sélectionnez Visual Studio dans le volet gauche, puis copiez votre URL source .

   

2. Configurer Visual Studio

Windows

1. Dans Visual Studio, sélectionnez Options>des outils.

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

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

4. Si vous avez activé des sources en amont dans votre flux, décochez la case nuget.org .

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

   

macOS

1. Créez un jeton d’accès personnel.

2. Dans Visual Studio, dans la barre de menus, sélectionnez Préférences.

3. Sélectionnez NuGet, puis sélectionnez Sources.

4. Sélectionnez Ajouter et entrer le nom de votre flux, l’URL source, un nom d’utilisateur (n’importe quelle chaîne) et votre jeton d’accès personnel.

5. Sélectionnez OK pour enregistrer votre source.

6. Si vous avez activé des sources en amont dans votre flux, décochez la case nuget.org .

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

   

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 .

   

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 des sources en amont n’est pas prise en charge.

Publier des packages

Pour publier votre package dans votre flux, exécutez la commande suivante. Vous pouvez entrer n’importe quelle chaîne pour l’argument ApiKey .

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
  

Remarque

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

Contenu connexe

• Publier des packages NuGet avec Azure Pipelines (YAML/classic)
• Publier des packages sur NuGet.org
• Utiliser des packages à partir de la galerie NuGet