Pubblicare e ripristinare pacchetti NuGet dalla riga di comando (dotnet)

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

Azure Artifacts consente di pubblicare e ripristinare i pacchetti NuGet da e verso il feed, consentendo di condividerli con altri utenti in base alle impostazioni di visibilità del feed. Questa guida illustra come configurare il progetto per pubblicare o ripristinare pacchetti usando l'interfaccia della riga di comando dotnet.

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.

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

• Scaricare e installare .NET Core SDK (2.1.400+) .

Connetti a feed

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

2. Selezionare Connessione da inserire e quindi selezionare dotnet nella sezione NuGet a sinistra.

3. Creare un file nuget.config nella stessa cartella del file csproj o sln . Copiare il frammento XML seguente e incollarlo nel nuovo file, sostituendo i segnaposto con le informazioni pertinenti:

• Feed con ambito organizzazione:

  <?xml version="1.0" encoding="utf-8"?>
  <configuration>
    <packageSources>
      <clear />
      <add key="<FEED_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="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
    </packageSources>
  </configuration>
  

Pubblicare pacchetti

Eseguire il comando seguente per pubblicare un pacchetto nel feed. Sostituire i segnaposto con le informazioni appropriate:

dotnet nuget push --source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --api-key <ANY_STRING> <PACKAGE_PATH> 

Esempio: dotnet nuget push --source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --api-key AZ bin/MyPackage.5.0.2.nupkg

Nota

L'oggetto api-key viene utilizzato solo come segnaposto.

Pubblicare pacchetti da origini esterne

1. Creare un token di accesso personale con ambito di lettura e scrittura per la creazione di pacchetti.

2. Sostituire il segnaposto PERSONAL_ACCESS_TOKEN> con il token di accesso personale e quindi eseguire il comando seguente per aggiungere l'origine< del pacchetto al file nuget.config. Il token di accesso personale viene aggiunto al file nuget.config. Assicurarsi di archiviare il file in modo sicuro e non di archiviarlo nel controllo del codice sorgente.

   dotnet nuget add source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --name <SOURCE_NAME> --username <USER_NAME> --password <PERSONAL_ACCESS_TOKEN> --configfile <PATH_TO_NUGET_CONFIG_FILE>
   

3. Pubblicare il pacchetto:

   dotnet nuget push --source <SOURCE_NAME> --api-key <ANY_STRING> <PACKAGE_PATH>
   

Esempio: dotnet nuget add source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --name MySource --username MyUserName --password MyPersonalAccessToken --configfile ./nuget.configdotnet nuget push --source MySource --api-key AZ nupkgs/mypackage.1.1.0.nupkg

Nota

Se l'organizzazione usa un firewall o un server proxy, assicurarsi di consentire gli URL di dominio e gli indirizzi IP di Azure Artifacts.

Ripristinare pacchetti

Eseguire il comando seguente per ripristinare i pacchetti. Il --interactive flag viene usato per richiedere all'utente le credenziali:

dotnet restore --interactive

Articoli correlati

• Connessione ai feed di Azure Artifacts (NuGet.exe)
• Pubblicare pacchetti con Azure Pipelines (YAML/classico)
• Usare pacchetti dalla raccolta NuGet