Condividi tramite


Usare pacchetti dalla raccolta NuGet

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

Con le origini upstream di Azure Artifacts, gli sviluppatori possono usare pacchetti da registri pubblici, ad esempio nuget.org e npmjs.com. Questo articolo illustra il processo di configurazione del progetto e l'uso della riga di comando per usare in modo efficace i pacchetti NuGet dalla raccolta NuGet. In questo articolo si apprenderà come:

  • Abilitare le origini upstream per il feed
  • Aggiungere la raccolta NuGet come origine upstream
  • Connettersi al feed
  • Installare pacchetti da nuget.org

Prerequisiti

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

  • Feed di Azure Artifacts.

  • Scaricare NuGet.

  • Scaricare e installare il provider di credenziali di Azure Artifacts.

Abilitare le origini upstream nel feed

Se non è ancora stato creato un feed, seguire i passaggi seguenti per crearne uno nuovo e assicurarsi di selezionare la casella di controllo origini upstream per abilitarle. Se si dispone già di un feed, procedere con il passaggio successivo per aggiungere La raccolta NuGet come origine upstream.

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

  2. Selezionare Artefatti e quindi Crea feed.

  3. In Nome immettere un nome descrittivo per il feed.

    In Visibilità selezionare un'opzione per indicare chi può visualizzare i pacchetti all'interno del feed.

    Per includere pacchetti da origini pubbliche, selezionare la casella di controllo in Origini upstream.

    Per Ambito specificare se l'ambito del feed è il progetto o l'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 Crea feed.

  3. In Nome immettere un nome descrittivo per il feed.

    In Visibilità selezionare un'opzione per indicare chi può visualizzare i pacchetti all'interno del feed.

    Per includere pacchetti da origini pubbliche, selezionare la casella di controllo in Origini upstream.

    Per Ambito specificare se l'ambito del feed è il progetto o l'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.

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

  2. Selezionare Artefatti e quindi nuovo feed.

  3. In Nome immettere un nome descrittivo per il feed.

    In Visibilità selezionare un'opzione per indicare chi può visualizzare i pacchetti all'interno del feed.

    Per includere pacchetti da origini pubbliche, selezionare l'opzione Usa pacchetti da origini pubbliche tramite questa opzione di feed .

  4. Al termine, fare clic su Crea.

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

Nota

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

Se è stata selezionata la casella di controllo origini upstream durante la creazione del feed, La raccolta NuGet dovrebbe essere stata aggiunta automaticamente. In caso contrario, aggiungerlo manualmente seguendo questa procedura:

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

  2. Selezionare Artefatti e quindi selezionare il feed.

  3. Selezionare il pulsante Icona a forma di ingranaggio icona a forma di ingranaggio per passare alle impostazioni del feed.

  4. Selezionare Origini upstream e quindi Aggiungi upstream per aggiungere una nuova origine upstream .

  5. Selezionare Origine pubblica e quindi selezionare Raccolta NuGet dal menu a discesa.

  6. Selezionare Aggiungi al termine e quindi selezionare Salva ancora una volta nell'angolo in alto a destra per salvare le modifiche.

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

  2. Selezionare Artefatti e quindi selezionare il feed.

  3. Selezionare il pulsante Icona a forma di ingranaggio icona a forma di ingranaggio per passare alle impostazioni del feed.

  4. Selezionare Origini upstream e quindi Aggiungi upstream.

  5. Selezionare Origine pubblica e quindi selezionare Raccolta NuGet dal menu a discesa.

  6. Selezionare Salva al termine e quindi selezionare Salva ancora una volta nell'angolo in alto a destra per salvare le modifiche.

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

  2. Selezionare Artefatti e quindi selezionare il feed.

  3. Selezionare il pulsante Icona a forma di ingranaggio icona a forma di ingranaggio per passare alle impostazioni del feed.

  4. Selezionare Origini upstream e quindi Aggiungi origine upstream.

  5. Selezionare Origine pubblica e quindi selezionare Raccolta NuGet dal menu a discesa.

  6. Al termine, selezionare Aggiungi .

Connetti a feed

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

  2. Selezionare Artefatti e quindi selezionare il feed.

  3. Selezionare Connetti al feed e quindi selezionare NuGet.exe.

  4. Aggiungere un file nuget.config nella stessa cartella del file con estensione csproj o .sln . Incollare il frammento XML specificato nel file. Se si usano gli esempi seguenti, assicurarsi di sostituire i segnaposto con i valori appropriati per lo scenario.

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

  2. Selezionare Artefatti e quindi selezionare il feed.

  3. Selezionare Connetti al 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 Connetti al 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 .

Con il progetto ora configurato per l'autenticazione con il feed, è ora possibile procedere all'installazione di pacchetti dalla raccolta NuGet a monte. In questo esempio verrà installata la libreria di registrazione diagnostica Serilog :

  1. Passare alla raccolta NuGet all'indirizzo https://www.nuget.org/.

  2. Cercare il pacchetto Serilog e quindi selezionarlo per passare alla pagina dei dettagli.

  3. Selezionare la scheda Gestione pacchetti e copiare il comando. In questo esempio il comando è il seguente:

    NuGet\Install-Package Serilog -Version 3.1.2-dev-02097
    
  4. Aprire il progetto in Visual Studio e quindi selezionare Strumenti>nuGet Gestione pacchetti> Gestione pacchetti Console per aprire la finestra della console.

  5. Incollare il comando nella finestra della console di Gestione pacchetti e premere INVIO per installare il pacchetto.

Nota

Per salvare i pacchetti da upstream, è necessario avere il ruolo Feed e lettore upstream (collaboratore) o versione successiva. Per altri dettagli, vedere Gestire le autorizzazioni .

Visualizzare i pacchetti salvati

  1. Accedere all'organizzazione di Azure DevOps e passare al progetto.
  1. Accedere al server Azure DevOps e quindi passare al progetto.
  1. Selezionare Artefatti e quindi selezionare il feed dal menu a discesa.

  2. Selezionare l'origine della raccolta NuGet dal menu a discesa per filtrare i pacchetti da questo upstream.

  3. Il pacchetto Serilog , installato nel passaggio precedente, è ora disponibile nel feed. Azure Artifacts ha salvato automaticamente una copia nel feed quando è stato eseguito il comando di installazione.

    Screenshot che mostra il pacchetto salvato da upstream.