Публикация и восстановление пакетов NuGet из командной строки (dotnet)

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

Артефакты Azure позволяют публиковать и восстанавливать пакеты NuGet в веб-канале и совместно использовать их с другими пользователями в соответствии с параметрами видимости веб-канала. В этом руководстве описывается настройка проекта для публикации или восстановления пакетов с помощью интерфейса командной строки dotnet.

Необходимые компоненты

• Организация Azure DevOps и проект. Создайте организацию или проект, если вы еще не сделали этого.

• Веб-канал артефактов Azure. Создайте веб-канал , если у вас еще нет.

• Скачайте и установите поставщик учетных данных Azure Artifacts.

• Скачайте и установите пакет SDK для .NET Core (2.1.400+).

Подключиться к веб-каналу

1. Выберите артефакты и выберите веб-канал в раскрывающемся меню.

2. Выберите Подключение для канала, а затем выберите dotnet в разделе NuGet слева.

3. Создайте файл nuget.config в той же папке, что и файл csproj или sln. Скопируйте следующий фрагмент XML-кода и вставьте его в новый файл, заменив заполнители соответствующими сведениями:

• Веб-канал область организации:

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

• Веб-канал Project-область d:

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

Публикация пакетов

Выполните следующую команду, чтобы опубликовать пакет в веб-канале. Замените заполнители соответствующими сведениями:

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> 

Пример: 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

Примечание.

Используется api-key только в качестве заполнителя.

Публикация пакетов из внешних источников

1. Создайте личный маркер доступа (PAT) с упаковкой область чтения и записи.

2. Замените <заполнитель PERSONAL_ACCESS_TOKEN> личным маркером доступа, а затем выполните следующую команду, чтобы добавить источник пакета в файл nuget.config. Это добавляет PAT в конфигурацию nuget.config. Не забудьте безопасно хранить этот файл и не проверка его в управление версиями.

   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. Опубликуйте пакет:

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

Пример: 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.nupkgkg

Примечание.

Если ваша организация использует брандмауэр или прокси-сервер, убедитесь, что вы разрешаете URL-адреса и IP-адреса домена Azure Artifacts.

Восстановление пакетов

Выполните следующую команду, чтобы восстановить пакеты. Флаг --interactive используется для запроса пользователя на получение учетных данных:

dotnet restore --interactive

Связанные статьи

• Подключение веб-каналы Артефактов Azure (NuGet.exe)
• Публикация пакетов с помощью Azure Pipelines (YAML/Classic)
• Использование пакетов из коллекции NuGet