Delen via

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

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

Met Azure Artifacts 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 Artifacts-feed.

Vereiste voorwaarden

Product Eisen
Azure DevOps - Een Azure DevOps organisatie.
- Een Azure DevOps--project.
- Een Azure Artifacts feed.
- Download en installeer vervolgens de Azure Artifacts Credential Provider.
- Installeer de nieuwste NuGet-versie.

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 Artifacts is nuGet-versie 4.8.0.5385 of hoger vereist. Voor optimale prestaties raadt Azure Artifacts 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 Artifacts-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