Condividi tramite


Guida introduttiva: Introduzione ai pacchetti NuGet in Azure Artifacts

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

Azure Artifacts consente agli sviluppatori di pubblicare e scaricare pacchetti NuGet da origini come feed e registri pubblici. Con Azure Artifacts è possibile creare feed che sono i seguenti:

  • Privato, in modo da poter condividere pacchetti con il team e con utenti specifici.
  • Pubblico, quindi è possibile condividere i pacchetti apertamente con chiunque su Internet.

In questa guida introduttiva si apprende come:

  • Creare un nuovo feed.
  • Configurare il progetto e connettersi al feed.
  • Pubblicare pacchetti NuGet.
  • Scaricare i pacchetti dal feed.

Prerequisiti

Creare un feed

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

  2. Seleziona Artefatti, e quindi seleziona Crea feed.

  3. Specificare un Nome per il feed, scegliere l'opzione Visibilità che definisce chi può visualizzare i pacchetti, selezionare Includi pacchetti da origini pubbliche comuni se si desidera includere pacchetti da fonti come nuget.org o npmjs.com, e per l'opzione Ambitodecidere se il feed deve essere limitato al progetto o all'intera organizzazione.

  4. Al termine, fare clic su Crea.

    Screenshot che mostra le selezioni per la creazione di un nuovo feed in Azure DevOps Services.

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

  2. Selezionare Artefatti e quindi selezionare Crea feed.

  3. Specificare un Nome per il feed, scegliere l'opzione Visibilità che definisce chi può visualizzare i pacchetti, selezionare Includi pacchetti da origini pubbliche comuni se si desidera includere pacchetti da fonti come nuget.org o npmjs.com, e per l'opzione Ambitodecidere se il feed deve essere limitato al progetto o all'intera organizzazione.

  1. Al termine, fare clic su Crea.

    Screenshot che mostra le selezioni per la creazione di un nuovo feed in Azure DevOps 2022.

  1. Al termine, fare clic su Crea.

    Screenshot che mostra le selezioni per la creazione di un nuovo feed in Azure DevOps 2020.

Nota

Per impostazione predefinita, i feed appena creati hanno il valore del servizio di compilazione del progetto impostato su Feed e lettore upstream (collaboratore).

Connettersi a un feed

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

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

  3. Selezionare Connetti al feed e quindi selezionare NuGet.exe nel riquadro sinistro. Se è la prima volta che si usa Azure Artifacts con Nuget.exe, assicurarsi di aver installato tutti i prerequisiti.

    Screenshot che mostra il pulsante per la connessione a un feed.

  4. Seguire le istruzioni nella sezione Configurazione del progetto per configurare il file nuget.config ed eseguire l'autenticazione con Azure Artifacts.

    Screenshot che mostra le istruzioni visualizzate per la configurazione di un progetto.

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

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

  3. Selezionare Connetti al feed e quindi selezionare NuGet.exe nel riquadro sinistro.

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

    Screenshot che mostra le istruzioni visualizzate per la configurazione di un progetto NuGet in Azure DevOps Server 2020 e 2022.

Download dei pacchetti

1. Ottenere l'URL dell'origine del pacchetto

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

  2. Selezionare Artifacti, selezionare il tuo feed dal menu a discesa e quindi selezionare Connetti al feed.

  3. Selezionare Visual Studio nel riquadro di spostamento a sinistra, quindi copiare il proprio URL origine.

    Screenshot che mostra come trovare l'URL di origine del feed.

2. Configurare Visual Studio

  1. In Visual Studio selezionare Opzioni strumenti>.

  2. Espandere la sezione Gestione pacchetti NuGet e quindi selezionare Origini pacchetto.

  3. Immettere il valore Name del feed e l'URL di origine e quindi selezionare il segno più verde (+) per aggiungere un'origine.

  4. Se nel feed sono state abilitate le origini upstream, rimuovere la selezione dalla casella di controllo nuget.org.

  5. Una volta terminata l’operazione, fare clic su OK.

    Screenshot che mostra le selezioni per la configurazione di Visual Studio in Windows.

3. Scaricare i pacchetti

  1. In Visual Studio fare clic con il pulsante destro del mouse sul progetto e quindi scegliere Gestisci pacchetti NuGet.

  2. Selezionare Sfoglia e quindi selezionare il feed dal menu a discesa Origine pacchetto .

    Screenshot che mostra la selezione di un'origine del pacchetto in Visual Studio.

  3. Usare la barra di ricerca per cercare i pacchetti dal feed.

Nota

L'uso di Esplora pacchetti NuGet per cercare pacchetti in origini upstream non è supportato.

Pubblicare pacchetti

Per pubblicare il pacchetto nel feed, eseguire il comando seguente. È possibile immettere qualsiasi stringa per l'argomento ApiKey .

nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>

Esempi:

  • Feed con ambito progetto:

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    
  • Feed con ambito organizzazione:

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/_packaging/myFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    

Nota

ApiKey è obbligatorio, ma è possibile usare qualsiasi valore arbitrario durante la pubblicazione nei feed di Azure Artifacts.