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 fournisseur d’informations d’identification Azure Artifacts. - Donwload et installez la dernière version de NuGet.
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éparer votre package

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 GitHub Copilot, demandez à GitHub copilot d’ajouter votre package metada. 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 générer 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 à 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.

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 dans l’étendue du 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 d’étendue 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 2025-12-17