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
Les sources en amont d’Azure Artifacts facilitent l’extraction de packages à partir de registres publics tels que nuget.org et npmjs.com. Dans cet article, vous allez apprendre à configurer votre projet et à utiliser la ligne de commande pour consommer des packages NuGet à partir de la galerie NuGet.
Prérequis
| Produit | Exigences |
|---|---|
| Azure DevOps | - Une organisation Azure DevOps . - Un projet Azure DevOps . - Un flux Azure Artifacts. - Téléchargez et installez le fournisseur d’informations d’identification Azure Artifacts. - Installez la dernière version de NuGet. |
Créer un flux et activer des sources en amont
Si vous n’avez pas encore créé de flux, suivez les étapes ci-dessous pour créer un flux et activer des sources en amont. Si vous disposez déjà d’un flux, passez à l’étape suivante pour ajouter la galerie NuGet en tant que source en amont.
Connectez-vous à votre organisation Azure DevOps et accédez à votre projet.
Sélectionnez Artifacts, puis sélectionnez Créer un flux.
Fournissez un nom pour votre flux, sélectionnez l’option Visibilité pour définir qui peut afficher vos packages et choisir votre étendue. Azure Artifacts recommande des flux d’étendue à un projet plutôt qu’à l’ensemble de l’organisation.
Veillez à vérifier les packages Include à partir de l’option de sources publiques courantes , car vous en aurez besoin pour consommer des packages à partir de registres publics tels que nuget.org, npmjs.com etc.
Sélectionnez Créer lorsque vous avez terminé.
Ajouter nuGet Gallery amont source
Si vous cochez la case Sources en amont lors de la création de votre flux (comme indiqué dans la section précédente), la galerie NuGet doit avoir été ajoutée automatiquement aux sources en amont de votre flux. Si vous utilisez un autre flux ou si vous avez oublié de vérifier cette option, vous pouvez ajouter manuellement la galerie NuGet en procédant comme suit :
Connectez-vous à Azure DevOps, puis accédez à votre projet.
Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant.
Sélectionnez le bouton
d’icône d’engrenage pour accéder à vos paramètres de flux.
Sélectionnez Sources en amont, puis Ajouter en amont.
Sélectionnez Source publique, sélectionnez NuGet Gallery dans le menu déroulant, puis sélectionnez Ajouter.
Sélectionnez Enregistrer en haut à droite, puis sélectionnez Enregistrer à nouveau pour confirmer et appliquer vos modifications.
Se connecter à votre flux
Dans cette section, vous allez apprendre à configurer votre projet pour vous authentifier auprès de votre flux Azure Artifacts et enregistrer des packages à partir de sources en amont telles que la galerie NuGet.
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électionnezNuGet.exe.
Vérifiez que vous avez installé les prérequis, puis ajoutez un fichier nuget.config dans le même dossier que votre fichier .csproj ou .sln .
Collez l’extrait de code XML fourni dans la section d’installation du projet dans votre fichier. Votre fichier doit ressembler à ce qui suit :
Flux dans l’étendue du projet :
<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <clear /> <add key="<SOURCE_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="<SOURCE_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 NuGet.exe dans le volet de navigation gauche.
Suivez les instructions de la section Configuration de Project pour vous connecter à votre flux.
Installer des packages à partir de NuGet Gallery
Maintenant que votre projet est configuré pour s’authentifier avec votre flux Azure Artifacts, vous pouvez continuer à installer des packages à partir de la galerie NuGet en amont. Dans cet exemple, vous allez installer le Kit de développement logiciel (SDK) MCP C# pour le protocole de contexte de modèle pour les applications .NET afin d’interagir avec les clients et serveurs MCP :
Accédez à la galerie NuGet à l’adresse
https://www.nuget.org/.Recherchez le ModelContextProtocol, puis sélectionnez-le pour ouvrir la page de détails.
Sélectionnez l’onglet CLI .NET , puis copiez la commande. Dans cet exemple, la commande est :
dotnet add package ModelContextProtocol --version 0.3.0-preview.4Ouvrez une fenêtre d’invite de commandes, accédez au répertoire de votre projet, puis collez votre commande, puis appuyez sur Entrée pour installer le package.
Une fois installé, une copie du package est automatiquement enregistrée dans votre flux, ce qui garantit la disponibilité si NuGet Gallery est en panne et protège votre flux de travail contre d’autres packages endommagés ou malveillants du registre public.
Remarque
Pour enregistrer des packages à partir d’amont, vous devez disposer du rôle Flux et Lecteur en amont (Collaborateur) ou supérieur. Pour plus d’informations, consultez rôles de flux et autorisations .
Afficher les packages enregistrés
Connectez-vous à Azure DevOps et accédez à votre projet.
Sélectionnez Artefacts, puis sélectionnez votre flux dans le menu déroulant.
Sélectionnez la source de la galerie NuGet dans le menu déroulant pour filtrer les packages à partir de cet amont.
Les packages ModelContextProtocol , installés à l’étape précédente, sont désormais disponibles dans notre flux. Azure Artifacts a automatiquement enregistré une copie dans votre flux.
