Condividi tramite


Connessione ai feed di Azure Artifacts (NuGet.exe)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure Artifacts consente agli sviluppatori di pubblicare e scaricare pacchetti NuGet da varie origini, inclusi feed e registri pubblici. È possibile usare feed privati di Azure Artifacts per condividere i pacchetti privatamente con il team o con utenti specifici. Inoltre, è possibile creare feed pubblici per rendere i pacchetti accessibili pubblicamente, consentendo di condividerli apertamente con chiunque su Internet. Questo articolo illustra come connettersi al feed di Azure Artifacts.

Prerequisiti

  • Un'organizzazione Di Azure DevOps e un progetto. Creare un'organizzazione o un progetto, se non è già stato fatto.

  • Feed di Azure Artifacts. Crea un nuovo feed se non ne hai già uno.

  • Installare la versione più recente di NuGet.

  • Installare il provider di credenziali di Azure Artifacts.

Impostazione progetto

  1. Accedere all'organizzazione di Azure DevOps e passare al progetto.

  2. Selezionare Artefatti e quindi selezionare il feed dal menu a discesa.

  3. Selezionare Connessione da inserire e quindi selezionare NuGet.exe nel pannello a sinistra.

  4. Se è la prima volta che si usa Azure Artifacts con NuGet.exe, assicurarsi di aver installato i prerequisiti. In caso contrario, selezionare Ottieni gli strumenti nell'angolo superiore destro per installarli.

  5. Aggiungere un file nuget.config al progetto, inserirlo nella stessa cartella del file csproj o sln e quindi incollarvi il frammento specificato. Il frammento di codice deve essere strutturato come segue:

    • Feed con ambito progetto:

      <?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>
      
    • Feed con ambito organizzazione:

      <?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. Accedere al server Azure DevOps e quindi passare al progetto.

  2. Selezionare Artefatti e quindi selezionare il feed dal menu a discesa.

  3. Selezionare Connessione da feed e quindi selezionare NuGet.exe nel riquadro di spostamento a sinistra.

  4. Seguire le istruzioni nella sezione Configurazione del progetto per connettersi al feed.

  1. Accedere al server Azure DevOps e quindi passare al progetto.

  2. Selezionare Artefatti e quindi selezionare il feed.

  3. Selezionare Connessione in Feed e quindi selezionare NuGet nel riquadro di spostamento a sinistra.

  4. Seguire le istruzioni fornite per aggiungere l'URL dell'origine del pacchetto al file nuget.config .

Importante

Il provider di credenziali di Azure Artifacts richiede NuGet 4.8.0.5385 o versione successiva.

Per ottenere prestazioni ottimali, Azure Artifacts consiglia di usare la versione 5.5.x NuGet o versioni successive, in quanto include correzioni di bug cruciali correlate ad annullamenti e timeout.

Configurazione del progetto legacy

Se si usa una versione precedente di NuGet, seguire le istruzioni seguenti per connettersi al feed:

  1. Accedere all'organizzazione di Azure DevOps e passare al progetto.

  2. Selezionare Artefatti e quindi selezionare il feed dal menu a discesa.

  3. Selezionare Connessione da inserire e quindi selezionare NuGet.exe nel pannello a sinistra.

  4. Copiare l'URL di origine e quindi sostituire /v3/index.json con /v2. L'URL di origine aggiornato dovrebbe essere simile al seguente:

    • Feed con ambito progetto:

      https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2
      
    • Feed con ambito organizzazione:

      https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2
      
  5. Creare un token di accesso personale e assicurarsi di definire l'ambito per l'organizzazione appropriata a cui si vuole accedere e selezionare uno degli ambiti seguenti: Creazione di pacchetti (lettura), Creazione di pacchetti (lettura e scrittura) o Creazione di pacchetti (lettura, scrittura e gestione) .

  6. Eseguire il comando seguente in una finestra del prompt dei comandi per aggiungere l'origine del feed al file nuget.config :

    nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <ANY_STRING_BUT_NOT_NULL> -password <YOUR_PERSONAL_ACCESS_TOKEN>
    
  7. Se l'organizzazione è connessa all'ID Microsoft Entra, è prima necessario eseguire l'autenticazione con le credenziali di AD e quindi aggiungere il token di accesso personale usando il comando 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>