Herstellen einer Verbindung mit Azure Artifacts Feeds mithilfe von NuGet.exe

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

Azure Artifacts hilft Ihnen, Ihre Pakete aus einem einzigen Feed zu speichern und zu verwalten. Sie können Pakete innerhalb Ihres Teams, organisationsübergreifend oder öffentlich freigeben. In diesem Artikel erfahren Sie, wie Sie Ihr Projekt einrichten und sich mithilfe von NuGet.exebei Ihrem Azure Artifacts-Feed authentifizieren.

Voraussetzungen

Produkt Anforderungen
Azure DevOps - Eine Azure DevOps Organisation.
- Ein Azure DevOps Projekt.
- Ein Azure Artifacts-Feed.
– Herunterladen und Installieren nuget.exe Version 4.8.0.5385 oder höher. Wir empfehlen NuGet 5.5.x oder höher, das wichtige Fehlerbehebungen für Abbrüche und Timeouts enthält.

Richten Sie den Anmeldeinformationsanbieter für Azure Artifacts ein

Der Azure Artifacts-Anmeldeinformationsanbieter ermöglicht die sichere Authentifizierung bei Ihren Azure Artifacts-Feeds. Um es mit nuget.exezu verwenden, müssen Sie es zuerst zum Plug-In-Suchpfad von NuGet hinzufügen. Ausführliche Informationen finden Sie unter Plug-In-Installation und Ermittlung. Nachdem das Plug-In hinzugefügt wurde, führen Sie die Installationsschritte für Ihr Betriebssystem unten aus:

Verwenden Sie eine der folgenden Methoden, um den Anmeldeinformationsanbieter für Azure Artifacts zu installieren:

Manuelle Installation

  1. Laden Sie die neueste version Microsoft.NetFx48.NuGet.CredentialProvider.zip herunter.

  2. Extrahieren Sie die ZIP-Datei.

  3. Kopieren Sie den netfx Ordner aus dem extrahierten Archiv in %UserProfile%/.nuget/plugins/. Der netfx Ordner ist für nuget.exe Kompatibilität erforderlich.

Installieren mit dem Hilfsskript

Alternativ können Sie das Hilfsskript verwenden, um die Installation zu automatisieren. Stellen Sie sicher, dass Sie Über PowerShell 5.1 oder höher verfügen, und führen Sie dann Folgendes aus:

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

Weitere Informationen finden Sie im Repository Azure Artifacts Credential Provider.

Projektkonfiguration

Führen Sie die folgenden Schritte aus, um Ihr Projekt einzurichten und Ihren Feed zu Ihrer nuget.config Datei hinzuzufügen, damit NuGet weiß, wo Pakete wiederhergestellt und veröffentlicht werden sollen. Die verwendete Feed-URL hängt davon ab, ob Ihr Feed auf ein Projekt oder auf die Organisation ausgerichtet ist.

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann Ihren Feed im Dropdownmenü aus.

  3. Wählen Sie im Navigationsbereich links Verbindung mit Feed herstellen und dann NuGet.exe aus.

  4. Fügen Sie ihrem Projekt eine nuget.config Datei im selben Ordner wie Ihre .csproj Oder-Datei .sln hinzu, und fügen Sie dann den bereitgestellten Codeausschnitt in das Projekt ein. Ihre nuget.config Datei sollte einem der folgenden Beispiele ähneln:

    • Projektbezogener Feed:

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

    • Organisationsspezifischer 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. Melden Sie sich bei Ihrer Azure DevOps-Sammlung an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann Ihren Feed im Dropdownmenü aus.

  3. Wählen Sie Verbinden mit Feed, und wählen Sie dann NuGet.exe aus dem linken Navigationsbereich.

  4. Fügen Sie Ihrem Projekt eine nuget.config-Datei im selben Ordner wie Ihre .csproj- oder .sln-Datei hinzu, und fügen Sie dann den im Abschnitt Projekteinrichtung bereitgestellten Codeausschnitt in Ihre Datei ein.

Hinweis

Der Azure Artifacts Anmeldeinformationsanbieter erfordert NuGet-Version 4.8.0.5385 oder höher. Azure Artifacts empfiehlt NuGet 5.5.x oder höher für optimale Kompatibilität und Zuverlässigkeit.

Einrichtung von Legacy-Projekten

Wenn Sie eine ältere Version von NuGet verwenden, die den empfohlenen v3-Fluss nicht unterstützt, können Sie weiterhin eine Verbindung mit Ihrem Feed herstellen, indem Sie den älteren v2-Endpunkt und ein persönliches Zugriffstoken (Personal Access Token, PAT) verwenden. Verwenden Sie diesen Ansatz nur, wenn Sie nicht zu einem neueren Client wechseln können.

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann Ihren Feed im Dropdownmenü aus.

  3. Wählen Sie "Mit Feed verbinden" aus, und wählen Sie dann NuGet.exe von links aus.

  4. Kopieren Sie die Quell-URL aus dem Abschnitt "Project-Setup ", und ersetzen Sie /v3/index.json dann durch /v2. Die aktualisierte Quell-URL sollte wie folgt aussehen:

    • Projektbezogener Feed:

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

    • Organisationsspezifischer Feed:

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

  5. Erstellen Sie ein persönliches Zugriffstoken. Legen Sie das Token auf die Organisation fest, auf die Sie zugreifen möchten, und wählen Sie dann entsprechend Ihren Anforderungen einen der folgenden Bereiche aus: Paketverwaltung (Lesen), Paketverwaltung (Lesen und Schreiben) oder Paketverwaltung (Lesen, Schreiben und Verwalten).

  6. Führen Sie den folgenden Befehl in einem Eingabeaufforderungsfenster aus, um Ihre Feedquelle zu Ihrer nuget.config Datei hinzuzufügen:

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

  7. Wenn Ihre Organisation mit Microsoft Entra ID verbunden ist, authentifizieren Sie sich zuerst mit Ihren Microsoft Entra Anmeldeinformationen, und fügen Sie dann Ihr persönliches Zugriffstoken mithilfe des setapikey Befehls hinzu:

    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>

Authentifizieren mithilfe von Dienstprinzipalen

Verwenden Sie die Dienstprinzipalauthentifizierung für Automatisierungsszenarien, in denen die interaktive Anmeldung nicht geeignet ist. Wenn Sie sich mit einem Azure Artifacts Feed mithilfe eines Dienstprinzipals authentifizieren möchten, legen Sie die ARTIFACTS_CREDENTIALPROVIDER_FEED_ENDPOINTS Umgebungsvariable fest, wie in den folgenden Beispielen gezeigt.

Die Variable gibt Ihre Feed-URL, die Dienstprinzipalanwendungs-ID (Client-ID) und entweder den Zertifikatantragstellernamen oder den Zertifikatdateipfad an. Sie benötigen nur einen der Zertifikatwerte.

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

Verwandte Inhalte

  • Last updated on