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>
     

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> 
   

Articoli correlati

• Pubblicare e ripristinare pacchetti NuGet (NuGet.exe)
• Pubblicare pacchetti NuGet con Azure Pipelines
• Usare pacchetti da NuGet.org