Connectez-vous aux flux Azure Artifacts à l’aide de NuGet.exe

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Azure Artifacts vous aide à stocker et à gérer vos packages à partir d’un seul flux. Vous pouvez partager des packages au sein de votre équipe, entre organisations ou, pour des projets publics existants, publiquement. Cet article vous montre comment configurer votre projet et vous authentifier auprès de votre flux de Azure Artifacts à l’aide de NuGet.exe.

Conditions préalables

Produit Exigences
Azure DevOps - Une organisation Azure DevOps .
- Un projet Azure DevOps .
- Un flux Azure Artifacts.
- Téléchargez et installez nuget.exe version 4.8.0.5385 ou ultérieure. Nous recommandons NuGet 5.5.x ou version ultérieure, qui inclut des correctifs de bogues importants pour les annulations et les délais d’expiration.

Configurer le fournisseur d’informations d’identification Azure Artifacts

Le fournisseur d’informations d’identification Azure Artifacts permet une authentification sécurisée à vos flux de Azure Artifacts. Pour l’utiliser avec nuget.exe, vous devez d’abord l’ajouter au chemin de recherche du plug-in NuGet. Pour plus d’informations, consultez Installation et découverte du plug-in. Une fois le plug-in ajouté, suivez les étapes d’installation de votre système d’exploitation ci-dessous :

Utilisez l’une des méthodes suivantes pour installer le fournisseur d’informations d’identification Azure Artifacts :

Installation manuelle

  1. Téléchargez la dernière version Microsoft.NetFx48.NuGet.CredentialProvider.zip.

  2. Extrayez le fichier zip.

  3. Copiez le netfx dossier de l’archive extraite vers %UserProfile%/.nuget/plugins/. Le netfx dossier est requis pour la compatibilité nuget.exe.

Installer à l’aide du script d’assistance

Vous pouvez également utiliser le script d’assistance pour automatiser l’installation. Vérifiez que vous disposez de PowerShell 5.1 ou version ultérieure, puis exécutez :

iex "& { $(irm https://aka.ms/install-artifacts-credprovider.ps1) } -AddNetfx"

Pour plus d’informations, consultez le référentiel Azure Artifacts Credential Provider.

Configuration du projet

Suivez ces étapes pour configurer votre projet et ajouter votre flux à votre nuget.config fichier afin que NuGet sache où restaurer et publier des packages. L’URL du flux que vous utilisez dépend du fait que votre flux est lié à un projet ou à l’organisation.

  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 de navigation gauche.

  4. Ajoutez un nuget.config fichier à votre projet dans le même dossier que votre .csproj ou .sln fichier, puis collez l’extrait de code fourni dans celui-ci. Votre nuget.config fichier doit ressembler à l’un des exemples suivants :

    • Flux à l'échelle 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 à l'échelle 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>

  1. Connectez-vous à votre collection 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 de navigation gauche.

  4. Ajoutez un nuget.config fichier à votre project dans le même dossier que votre .csproj ou .sln fichier, puis collez l’extrait de code fourni dans la section de configuration Project dans votre fichier.

Remarque

Le fournisseur d’informations d’identification Azure Artifacts nécessite la version de NuGet ou une version 4.8.0.5385 ultérieure. Azure Artifacts recommande NuGet 5.5.x ou version ultérieure pour la meilleure compatibilité et la fiabilité.

Configuration du projet hérité

Si vous utilisez une version antérieure de NuGet qui ne prend pas en charge le flux v3 recommandé, vous pouvez toujours vous connecter à votre flux à l’aide de l’ancien point de terminaison v2 et d’un jeton d’accès personnel (PAT). Utilisez cette approche uniquement lorsque vous ne pouvez pas passer à un client plus récent.

  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 à partir de gauche.

  4. Copiez votre URL source à partir de la section Installation de Project , puis remplacez /v3/index.json par /v2. Votre URL source mise à jour doit ressembler à l’une des options suivantes :

    • Flux à l'échelle du projet :

      https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2

    • Flux à l'échelle de l'organisation :

      https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2

  5. Créez un jeton d’accès personnel. Étendez le jeton à l’organisation à laquelle vous souhaitez accéder, puis sélectionnez l’une des étendues suivantes en fonction de vos besoins : Empaquetage (lecture),Empaquetage (lecture et écriture) ou Empaquetage (lecture, écriture et gestion) .

  6. Exécutez la commande suivante dans une fenêtre d’invite de commandes pour ajouter votre source de flux à votre fichier nuget.config :

    nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <ANY_STRING_BUT_NOT_NULL> -password <YOUR_PERSONAL_ACCESS_TOKEN>

  7. Si votre organisation est connectée à Microsoft Entra ID, commencez par vous authentifier auprès de vos informations d’identification Microsoft Entra, puis ajoutez votre jeton d’accès personnel à l’aide de la setapikey commande :

    nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <AZURE_ACTIVE_DIRECTORY_USERNAME> -password <AZURE_ACTIVE_DIRECTORY_PASSWORD>

nuget setapikey <YOUR_PERSONAL_ACCESS_TOKEN> -source <SOURCE_URL>

S’authentifier à l’aide de service principals

Utilisez l’authentification du principal de service pour les scénarios d’automatisation où la connexion interactive n’est pas appropriée. Pour vous authentifier auprès d’un flux Azure Artifacts à l’aide d’un principal de service, définissez la variable d’environnement ARTIFACTS_CREDENTIALPROVIDER_FEED_ENDPOINTS comme indiqué dans les exemples suivants.

La variable spécifie votre URL de flux, l’ID de l’application de principal de service (client) et le nom de l’objet du certificat ou le chemin du fichier de certificat. Vous n’avez besoin que de l’une des valeurs de certificat.

$env:ARTIFACTS_CREDENTIALPROVIDER_FEED_ENDPOINTS = @'{
    "endpointCredentials": [
        {
            "endpoint": "<FEED_URL>",
            "clientId": "<SERVICE_PRINCIPAL_APPLICATION_(CLIENT)_ID>",
            "clientCertificateSubjectName": "<SERVICE_PRINCIPAL_CERTIFICATE_NAME>",
            "clientCertificateFilePath": "<SERVICE_PRINCIPAL_CERTIFICATE_PATH>"
        }
    ]
}
'@

Contenu connexe

  • Last updated on