Dela via

Ansluta till en Azure Artifacts-feed (NuGet.exe)

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

Med Azure Artifacts kan utvecklare ladda ned NuGet-paket från olika källor, till exempel privata feeds och offentliga register. Du kan publicera paket till privata feeds och kontrollera åtkomsten, eller skapa offentliga feeds för att dela dem öppet. Den här artikeln vägleder dig genom att autentisera till din Azure Artifacts-feed.

Förutsättningar

Produkt Krav
Azure DevOps – En organisation i Azure DevOps .
– Ett Azure DevOps-projekt.
– Ett Azure Artifacts-flöde.
– Ladda ned och installera Azure Artifacts Credential Provider.
– Installera den senaste NuGet-versionen.

Projektinställningar

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Artefakter och välj sedan din feed från den nedrullningsbara menyn.

  3. Välj Anslut till feed och välj sedan NuGet.exe till vänster.

  4. Lägg till en nuget.config fil i projektet, placera den i samma mapp som csproj - eller sln-filen och klistra sedan in det angivna kodfragmentet i den. Filen nuget.config bör likna följande:

    • Projektspecifikt flöde:

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

    • Organisationsomfattande flöde:

      <?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. Logga in på din Azure DevOps-samling och navigera sedan till projektet.

  2. Välj Artefakter och välj sedan din feed från den nedrullningsbara menyn.

  3. Välj Anslut till feedoch välj sedan NuGet.exe i det vänstra navigeringsfönstret.

  4. Lägg till en nuget.config fil i projektet, placera den i samma mapp som csproj - eller sln-filen och klistra sedan in kodfragmentet i avsnittet Project setup i filen.

Anmärkning

Azure Artifacts Credential Provider kräver NuGet-version 4.8.0.5385 eller högre. För optimala prestanda rekommenderar Azure Artifacts att du använder NuGet-versionen 5.5.x eller senare, eftersom den innehåller viktiga felkorrigeringar som rör annulleringar och tidsgränser.

Äldre projektkonfiguration

Om du använder en äldre version av NuGet följer du anvisningarna nedan för att ansluta till feeden:

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Artefakter och välj sedan din feed från rullgardinsmenyn.

  3. Välj Anslut till feed och välj sedan NuGet.exe till vänster.

  4. Kopiera käll-URL:en från avsnittet Projektkonfiguration och ersätt /v3/index.json sedan med /v2. Den uppdaterade käll-URL:en bör se ut ungefär så här:

    • Projektspecifikt flöde:

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

    • Organisationsomfattande flöde:

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

  5. Skapa en personlig åtkomsttoken, se till att du omfångsanpassar den till rätt organisation som du vill komma åt och välj sedan något av följande omfång baserat på dina behov: Paketering (läs), Paketering (läsa och skriva)eller Paketering (läsa, skriva och hantera).

  6. Kör följande kommando i ett kommandotolksfönster för att lägga till din feedkälla i din nuget.config-fil:

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

  7. Om din organisation är ansluten till Microsoft Entra-ID måste du först autentisera med dina AD-autentiseringsuppgifter och sedan lägga till din personliga åtkomsttoken med kommandot setapikey :

    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>

Autentisera med tjänstens huvudnamn

Om du vill autentisera med en Azure Artifacts-feed med hjälp av tjänstens huvudnamn anger du ARTIFACTS_CREDENTIALPROVIDER_FEED_ENDPOINTS miljövariabel enligt nedan.

Detta anger din feed-URL, tjänstens huvudnamns program-ID (klient) och antingen ämnesnamnet eller filsökvägen för certifikatet för tjänstens huvudnamn (endast ett av dessa två krävs).

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

Relaterat innehåll