Publikowanie i przywracanie pakietów NuGet z wiersza polecenia (dotnet)

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Usługa Azure Artifacts umożliwia publikowanie i przywracanie pakietów NuGet do i z kanału informacyjnego, co umożliwia udostępnianie ich innym osobom zgodnie z ustawieniami widoczności kanału informacyjnego. Ten przewodnik przeprowadzi Cię przez proces konfigurowania projektu w celu publikowania lub przywracania pakietów przy użyciu interfejsu wiersza polecenia dotnet.

Wymagania wstępne

• Organizacja i projekt usługi Azure DevOps. Utwórz organizację lub projekt, jeśli jeszcze tego nie zrobiono.

• Źródło danych usługi Azure Artifacts. Utwórz nowe źródło danych , jeśli jeszcze go nie masz.

• Pobierz i zainstaluj dostawcę poświadczeń usługi Azure Artifacts.

• Pobierz i zainstaluj zestaw .NET Core SDK (2.1.400+).

Połączenie do kanału informacyjnego

1. Wybierz pozycję Artefakty, a następnie wybierz źródło danych z menu rozwijanego.

2. Wybierz pozycję Połączenie do kanału informacyjnego, a następnie wybierz pozycję dotnet w sekcji NuGet po lewej stronie.

3. Utwórz plik nuget.config w tym samym folderze co plik csproj lub sln. Skopiuj następujący fragment kodu XML i wklej go do nowego pliku, zastępując symbole zastępcze odpowiednimi informacjami:

• Kanał informacyjny o zakresie organizacji:

  <?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>
  

• Źródło danych o zakresie projektu:

  <?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>
  

Publikowanie pakietów

Uruchom następujące polecenie, aby opublikować pakiet w kanale informacyjnym. Zastąp symbole zastępcze odpowiednimi informacjami:

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> 

Przykład: 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

Uwaga

Element api-key jest używany tylko jako symbol zastępczy.

Publikowanie pakietów ze źródeł zewnętrznych

1. Utwórz osobisty token dostępu (PAT) z zakresem odczytu i zapisu pakietu.

2. Zastąp symbol zastępczy PERSONAL_ACCESS_TOKEN> osobistym tokenem dostępu, a następnie uruchom następujące polecenie, aby dodać źródło pakietu do pliku nuget.config.< Spowoduje to dodanie tokenu dostępu do pliku nuget.config. Pamiętaj, aby bezpiecznie zapisać ten plik i nie zaewidencjonować go w kontroli źródła.

   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. Opublikuj pakiet:

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

Przykład: 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

Uwaga

Jeśli twoja organizacja korzysta z zapory lub serwera proxy, upewnij się, że zezwalasz na adresy URL i adresy IP domeny usługi Azure Artifacts.

Przywracanie pakietów

Uruchom następujące polecenie, aby przywrócić pakiety. Flaga --interactive służy do monitowania użytkownika o podanie poświadczeń:

dotnet restore --interactive

Powiązane artykuły

• Połączenie do źródeł danych usługi Azure Artifacts (NuGet.exe)
• Publikowanie pakietów za pomocą usługi Azure Pipelines (YAML/Classic)
• Używanie pakietów z galerii NuGet