Verbinding maken met een Azure-artefacten-feed (NuGet.exe)

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

Met Azure-artefacten kunnen ontwikkelaars NuGet-pakketten downloaden uit verschillende bronnen, zoals privéfeeds en openbare registers. U kunt pakketten publiceren naar privéfeeds en de toegang beheren, of openbare feeds maken om ze open te delen. In dit artikel wordt u begeleid bij verificatie bij uw Azure-artefacten-feed.

Vereiste voorwaarden

Product Eisen
Azure DevOps - Een Azure DevOps organisatie.
- Een Azure DevOps--project.
- Een Azure-artefacten feed.
- Download en installeer nuget.exe versie 4.8.0.5385 of hoger. We raden NuGet 5.5.x of hoger aan, waaronder belangrijke bugfixes voor annuleringen en time-outs.

De Azure-artefacten-aanmeldingsgegevensprovider instellen

De Azure-artefacten Referentieprovider maakt beveiligde verificatie mogelijk voor uw Azure-artefacten-feeds. Als u het wilt gebruiken met nuget.exe, moet u deze eerst toevoegen aan het zoekpad voor invoegtoepassingen van NuGet. Zie Installatie en detectie van invoegtoepassingen voor meer informatie. Zodra de invoegtoepassing is toegevoegd, volgt u de installatiestappen voor uw besturingssysteem hieronder:

Gebruik een van de volgende methoden om de Azure-artefacten Referentieprovider te installeren:

Handmatige installatie

  1. Download de nieuwste Microsoft.NetFx48.NuGet.CredentialProvider.zip release.

  2. Pak het zip-bestand uit.

  3. Kopieer de netfx map uit het uitgepakte archief naar %UserProfile%/.nuget/plugins/. De netfx map is vereist voor nuget.exe compatibiliteit.

Installeren met behulp van het helperscript

U kunt ook het geautomatiseerde helperscript gebruiken voor een gestroomlijnde installatie. Zorg ervoor dat u PowerShell 5.1 of hoger hebt en voer het volgende uit:

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

Zie de opslagplaats Azure-artefacten Credential Provider voor meer informatie.

Projectopstelling

  1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

  2. Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.

  3. Selecteer Verbinding maken met feed en selecteer vervolgens NuGet.exe aan de linkerkant.

  4. Voeg een nuget.config bestand toe aan uw project, plaats het in dezelfde map als uw csproj - of sln-bestand en plak het opgegeven fragment erin. Het bestandnuget.config moet er ongeveer als volgt uitzien:

    • Feed voor projectbereik:

      <?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>

    • Organisatiegerichte feed:

      <?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. Meld u aan bij uw Azure DevOps-verzameling en navigeer vervolgens naar uw project.

  2. Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.

  3. Selecteer Verbinding maken met feeden selecteer vervolgens NuGet.exe in het linkernavigatiedeelvenster.

  4. Voeg een nuget.config bestand toe aan uw project, plaats het in dezelfde map als uw csproj - of sln-bestand en plak het fragment dat is opgegeven in de sectie Project-installatie in het bestand.

Opmerking

Voor de Referentieprovider voor Azure-artefacten is nuGet-versie 4.8.0.5385 of hoger vereist. Voor optimale prestaties raadt Azure-artefacten aan om nuGet-versie 5.5.x of hoger te gebruiken, omdat het cruciale bugfixes bevat met betrekking tot annuleringen en time-outs.

Oude projectopzet

Als u een oudere versie van NuGet gebruikt, volgt u de onderstaande instructies om verbinding te maken met uw feed:

  1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

  2. Selecteer Artefacten en selecteer vervolgens uw feed in de vervolgkeuzelijst.

  3. Selecteer Verbinding maken met feed en selecteer vervolgens NuGet.exe aan de linkerkant.

  4. Kopieer de bron-URL uit de sectie Project-installatie en vervang deze door /v3/index.json/v2. De bijgewerkte bron-URL moet er als volgt uitzien:

    • Feed voor projectbereik:

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

    • Organisatiegerichte feed:

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

  5. Maak een persoonlijk toegangstoken, zorg ervoor dat u het bereik van het token beperkt tot de juiste organisatie die u wilt openen en selecteer vervolgens een van de volgende bereiken op basis van uw behoeften: Verpakking (lezen), Verpakking (lezen en schrijven) of Verpakking (lezen, schrijven en beheren).

  6. Voer de volgende opdracht uit in een opdrachtpromptvenster om uw feedbron toe te voegen aan uw nuget.config bestand:

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

  7. Als uw organisatie is verbonden met Microsoft Entra ID, moet u zich eerst verifiëren met uw AD-referenties en vervolgens uw persoonlijke toegangstoken toevoegen met behulp van de setapikey-opdracht :

    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>

Authenticeren met behulp van service-principals

Als u wilt verifiëren met een Azure-artefacten-feed met behulp van een service-principal, stelt u de ARTIFACTS_CREDENTIALPROVIDER_FEED_ENDPOINTS omgevingsvariabele in, zoals hieronder wordt weergegeven.

Hiermee geeft u uw feed-URL, de toepassings-id (client) van de service-principal en de onderwerpnaam of het bestandspad van het service-principalcertificaat op (slechts één van deze twee is vereist).

$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>"
        }
    ]
}
'@

Verwante inhoud

  • Last updated on