Publier votre premier package dans un flux Azure Artifacts

Azure Artifacts permet aux développeurs de gérer efficacement toutes leurs dépendances à partir d’un seul flux. Les flux dans Azure Artifacts servent de référentiels organisationnels pour stocker, gérer et partager des packages au sein d’une équipe, entre les organisations ou publiquement sur Internet. Azure Artifacts prend en charge un large éventail de types de packages, notamment NuGet, npm, Python, Maven, Cargo et Packages universels.

Cet article vous guide tout au long de la publication de votre premier package NuGet sur un flux Azure Artifacts. Si vous le souhaitez, vous pouvez suivre les instructions pour utiliser GitHub Copilot pour vous aider à configurer votre projet et préparer votre package pour la publication.

Prérequis

Produit	Exigences
Azure DevOps	- Une organisation Azure DevOps . - Un projet Azure DevOps . - Téléchargez et installez le SDK .NET version 9.0.200 ou ultérieure.
GitHub Copilot (facultatif)	- Configurez GitHub Copilot et Visual Studio Code. Un essai gratuit gitHub Copilot de 30 jours est disponible si vous n’avez pas encore inscrit.

Créer un flux

Si vous disposez déjà d’un flux, vous pouvez ignorer cette section. Sinon, suivez les étapes ci-dessous pour créer un flux dans Azure Artifacts :

Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.
Sélectionnez Artifacts, puis sélectionnez Créer un flux.
Fournissez un nom descriptif pour votre flux et définissez sa visibilité pour définir qui peut afficher les packages dans votre flux. Définissez l’étendue de votre flux et cochez la case Sources en amont si vous souhaitez inclure des packages à partir de sources publiques.
Sélectionnez Créer lorsque vous avez terminé.

Connectez-vous à votre collection Azure DevOps puis accédez à votre projet.
Sélectionnez Artifacts, puis sélectionnez Créer un flux.
Fournissez un nom descriptif pour votre flux et définissez sa visibilité pour définir qui peut afficher les packages dans votre flux. Définissez l’étendue de votre flux et cochez la case Sources en amont si vous souhaitez inclure des packages à partir de sources publiques.

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

Préparez votre colis

Dans cet exemple, vous allez utiliser un exemple de bibliothèque de classes .NET Core et configurer vos métadonnées de package avant de générer le projet et de créer un package NuGet prêt à être publié sur votre flux. Si vous n’avez pas encore de projet, suivez les instructions de ce guide pour créer une bibliothèque de classes .NET à l’aide de Visual Studio Code.

Sans GitHub Copilot
Avec GitHub Copilot

Ouvrez votre projet dans Visual Studio Code, puis sélectionnez votre fichier csproj . Ajoutez vos métadonnées de package dans la <PropertyGroup> balise. Votre fichier doit ressembler à ce qui suit :

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <RootNamespace>demo_class_library</RootNamespace>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>

    <PackageId>YOUR_PACKAGE_NAME</PackageId>
    <Version>YOUR_PACKAGE_VERSION</Version>
    <Authors>YOUR_NAME</Authors>
    <Company>YOUR_COMPANY</Company>

  </PropertyGroup>

</Project>

Exécutez la commande suivante dans votre répertoire de projet pour générer votre projet et créer un package .nupkg . Votre package se trouvera dans le bin\release dossier.
```
dotnet pack
```

L’exemple suivant vous guide tout au long de l’utilisation de GitHub Copilot pour configurer votre package metada et préparer votre package pour la publication.

Ouvrez votre projet dans Visual Studio Code, puis sélectionnez le fichier csproj dans l’Explorateur pour l’ouvrir.
Sélectionnez l’icône de conversation en haut pour ouvrir GitHub Copilot Chat. Votre contexte de fichier actuel doit afficher le fichier .csproj .
Dans la zone d’invite de GitHub Copilot, demandez à GitHub Copilot d’ajouter les métadonnées de votre package. Vous pouvez utiliser l’invite suivante :
```
Add the following package metadata to my csproj file:
PackageId: demoNuGetPackage
Version: 1.0.0
Authors: user123
Company: FabrikamFiber
```
Après quelques secondes, GitHub Copilot vérifie que les métadonnées du package ont été ajoutées à votre fichier csproj .
Dans la zone d’invite GitHub Copilot, demandez à Copilot de compiler votre projet et de générer le package NuGet. Lorsque vous êtes invité à confirmer, sélectionnez Continuer.
Une fois la build réussie, GitHub Copilot vous invite à nouveau à confirmer la génération du package NuGet. Sélectionnez Continuer pour continuer.
Une fois l’opération terminée, vous verrez une confirmation que le package a été créé avec succès, y compris les métadonnées et l’emplacement où le package est enregistré localement.

Configurer le fournisseur d’informations d’identification Azure Artifacts

Pour vous authentifier auprès de votre flux, vous devez d’abord installer le fournisseur d’informations d’identification Azure Artifacts. À l’aide du programme d’installation d’outils inclus avec dotnet, vous pouvez installer le fournisseur d’informations d’identification à partir de l’interface CLI à l’aide de la commande suivante :

dotnet tool install --global Microsoft.Artifacts.CredentialProvider.NuGet.Tool

Si votre nuget.config au niveau du dépôt est configuré pour utiliser uniquement des sources Azure Artifacts, exécutez la commande d’installation en dehors de ce répertoire, ou définissez explicitement nuget.org comme source :

dotnet tool install --global Microsoft.Artifacts.CredentialProvider.NuGet.Tool --source https://api.nuget.org/v3/index.json

Si vous le souhaitez, verrouillez l’outil sur une version majeure (par exemple, dans les images de conteneur où la reproductibilité est importante) :

dotnet tool install --global Microsoft.Artifacts.CredentialProvider.NuGet.Tool --version 2.* --source https://api.nuget.org/v3/index.json

Première utilisation

La première fois que vous effectuez une opération qui nécessite une authentification, utilisez l’une des approches suivantes :

Exécutez la commande avec --interactive afin que dotnet puisse vous inviter à vous connecter. Il s’agit de l’approche recommandée pour la plupart des scénarios de développement locaux.

Avant d’exécuter une commande interactive, vérifiez que votre projet est configuré et que votre flux est ajouté à nuget.config. Pour plus d’informations sur la configuration, consultez la configuration du projet.

Une fois votre projet configuré et connecté à votre flux, accédez à votre répertoire de projet et exécutez :

dotnet restore --interactive

Cette commande vous connecte et acquiert un jeton de session. Une fois l’authentification réussie, vous pouvez exécuter des commandes authentifiées sans --interactive tant que le jeton de session mis en cache reste valide. Pour plus d’informations, consultez Emplacements du cache de jetons de session.

Pour les scénarios non interactifs, tels que les conteneurs Docker et l’automatisation personnalisée, fournissez des informations d’identification via des variables environment.

Pour Azure Pipelines, utilisez la tâche NuGetAuthenticate@1 pour vous authentifier auprès de votre flux avant d’exécuter des commandes telles que dotnet restore ou dotnet nuget push. Pour plus d’informations, consultez Restore NuGet packages with Azure Pipelines.

Se connecter à un flux

Suivez les étapes ci-dessous pour configurer votre projet et vous connecter à votre flux Azure Artifacts. Vérifiez que vous avez installé le fournisseur d’informations d’identification Azure Artifacts et la dernière version de NuGet, comme indiqué dans les conditions préalables.

Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.
Sélectionnez Artefacts , puis sélectionnez votre flux dans le menu déroulant.
Sélectionnez Se connecter au flux, puis sélectionnez dotnet dans la section NuGet .

Suivez les instructions de la configuration de Project pour configurer votre fichier nuget.config . La structure de votre fichier doit ressembler à l’une des options suivantes :

Flux limité au projet :

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
  </packageSources>
</configuration>

Flux à l’échelle de l’organisation :

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
  </packageSources>
</configuration>

Connectez-vous à votre collection Azure DevOps puis accédez à votre projet.
Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant.
Sélectionnez Se connecter au flux, puis sélectionnez dotnet dans le volet de navigation gauche.
Suivez les instructions de la section configuration de Project pour configurer votre fichier nuget.config .

Publier votre package

Exécutez la commande suivante à partir de votre répertoire de projet pour publier le package dans votre flux Azure Artifacts. Le --api-key paramètre est obligatoire, mais vous pouvez utiliser n’importe quelle valeur de chaîne lors de la publication sur Azure Artifacts.

dotnet nuget push --source <FEED_NAME> --api-key <ANY_STRING> <PACKAGE_PATH>

Étapes suivantes

Surveiller le stockage des artefacts Meilleures pratiques d'Azure Artifacts Partager des packages publiquement

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-05-13