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'organizzazione Azure DevOps e un progetto, se non è già stato fatto.

• Installare la versione più recente di NuGet.

• Installare il Azure Artifacts Credential Provider.

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.

   

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.

   

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

   

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.

   

2. Configurare Visual Studio

Windows

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.

   

macOS

1. Creare un token di accesso personale.

2. Nella barra dei menu di Visual Studio selezionare Preferenze.

3. Selezionare NuGet, e quindi Origini.

4. Selezionare Aggiungi e immettere il nome del feed, l'URL di origine, un nome utente (qualsiasi stringa) e il token di accesso personale.

5. Selezionare OK per salvare l'origine.

6. Se nel feed sono state abilitate le origini upstream, assicurati che la casella di controllo nuget.org non sia selezionata.

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

   

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 .

   

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.

Contenuto correlato

• Pubblicare pacchetti NuGet con Azure Pipelines (YAML/classico)
• Pubblicare pacchetti in NuGet.org
• Usare pacchetti dalla Galleria NuGet