Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Ce guide vous guide tout au long de la configuration de votre projet pour publier des packages NuGet à l’aide de l’interface de ligne de commande dotnet.
Conditions préalables
| Produit | Exigences |
|---|---|
| Azure DevOps | - Une organisation Azure DevOps . - Un projet Azure DevOps . - Un flux Azure Artifacts. - Téléchargez et installez le fournisseur de certificats d'Azure Artifacts . - Téléchargez et installez SDK .NET Core (2.1.400+). |
Créer un flux
Si vous avez déjà un flux, passez à l’étape suivante. Dans le cas contraire, suivez les instructions ci-dessous pour en créer un :
Connectez-vous à votre azure DevOps et accédez à votre projet.
Sélectionnez Artifacts, puis sélectionnez Créer un flux.
Entrez un nom descriptif pour votre flux et définissez sa visibilité (qui peut utiliser votre flux). Spécifiez l’étendue de votre flux et, si vous souhaitez inclure des packages à partir de sources publiques, cochez la case Inclure les packages provenant de sources publiques courantes .
Sélectionnez Créer lorsque vous avez terminé.
Se connecter à un flux
Avant de pouvoir publier des packages sur votre flux, vous devez vous authentifier auprès d’Azure Artifacts. Suivez les instructions ci-dessous pour configurer votre projet et vous authentifier avec votre flux :
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 dotnet dans la section NuGet à gauche.
Créez un fichier nuget.config dans le même dossier que votre csproj ou sln fichier. Copiez l’extrait de code XML suivant et collez-le dans votre nouveau fichier, en remplaçant les espaces réservés par les informations pertinentes :
<?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>
Connectez-vous à votre serveur Azure DevOps, puis accédez à votre projet.
Sélectionnez Artefacts, puis sélectionnez votre flux.
Sélectionnez Se connecter au flux, puis dotnet dans le volet de navigation de gauche.
Suivez les instructions de la section Configuration du projet pour vous connecter à votre flux.
Publier des packages dans un flux dans la même organisation
Exécutez la commande suivante pour publier un package sur votre flux. Remplacez les espaces réservés par les valeurs appropriées :
dotnet nuget push --source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --api-key <ANY_STRING> <PACKAGE_PATH>
Exemple:
dotnet nuget push --source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --api-key AZ bin/MyPackage.5.0.2.nupkg
Remarque
Le api-key paramètre est requis lors de la publication sur un flux Azure Artifacts, mais vous pouvez utiliser n’importe quelle chaîne comme valeur.
Publier des packages dans un flux dans une autre organisation
Pour publier vos packages NuGet dans un flux dans une autre organisation Azure DevOps, vous devez d’abord créer un jeton d’accès personnel (PAT) dans l’organisation cible, ajouter la nouvelle source de package à votre fichier de configuration, puis exécuter la commande de publication :
Naviguez jusqu'à l'organisation qui héberge le flux cible et créez un jeton d'accès personnel (PAT) avec la portée d'écriture Packaging>Read& .
Remplacez l’espace réservé <PERSONAL_ACCESS_TOKEN> par votre jeton d’accès personnel, puis exécutez la commande suivante pour ajouter votre source de package à votre fichier nuget.config. Assurez-vous que ce fichier est stocké en toute sécurité et qu'il n'est pas enregistré dans le contrôle de source.
dotnet nuget add source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --name <SOURCE_NAME> --username <USER_NAME> --password <PERSONAL_ACCESS_TOKEN> --configfile <PATH_TO_NUGET_CONFIG_FILE>Exécutez la commande suivante pour publier votre package :
dotnet nuget push --source <SOURCE_NAME> --api-key <ANY_STRING> <PACKAGE_PATH>
Exemple:
dotnet nuget add source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --name MySource --username MyUserName --password MyPersonalAccessToken --configfile ./nuget.config
dotnet nuget push --source MySource --api-key AZ nupkgs/mypackage.1.1.0.nupkg
Remarque
Si votre organisation utilise un pare-feu ou un serveur proxy, vérifiez que les URL et adresses IP du domaine Azure Artifacts sont autorisées .