Использование пакетов из коллекции NuGet

  • Мақала

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

С помощью источников вышестоящий артефактов Azure разработчики могут использовать пакеты из общедоступных реестров, таких как nuget.org и npmjs.com. В этой статье описан процесс настройки проекта и использования командной строки для эффективного использования пакетов NuGet из коллекции NuGet. В этой статье вы узнаете, как выполнять следующие задачи.

  • Включение источников вышестоящий для веб-канала
  • Добавление коллекции NuGet в качестве источника вышестоящий
  • Подключение в веб-канал
  • Установка пакетов из nuget.org

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

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

  • Веб-канал артефактов Azure.

  • Скачайте NuGet.

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

Включение источников вышестоящий в веб-канале

Если у вас нет веб-канала, выполните следующие действия, чтобы создать новую и убедиться, что проверка источники вышестоящий проверка box, чтобы включить их. Если у вас уже есть веб-канал, вы можете перейти к следующему шагу, чтобы добавить коллекцию NuGet в качестве источника вышестоящий.

  1. Войдите в организацию Azure DevOps и перейдите к проекту.

  2. Выберите артефакты и нажмите кнопку "Создать веб-канал", чтобы создать новый веб-канал .

  3. Введите описательное имя веб-канала и определите его видимость (указывающее, кто может просматривать пакеты в веб-канале). Укажите область веб-канала и, если вы хотите включить пакеты из общедоступных источников, помечайте источники upstream проверка box.

  4. После завершения работы выберите Создать.

    Снимок экрана, показывающий, как создать веб-канал необходимости.

Примечание.

По умолчанию только что созданные веб-каналы имеют службу сборки проекта для веб-канала и средства чтения upstream (соавтор).

Если вы проверка источники вышестоящий проверка при создании веб-канала, коллекция NuGet должна быть добавлена автоматически. Если нет, добавьте его вручную, выполнив следующие действия:

  1. Войдите в организацию Azure DevOps и перейдите к проекту.

  2. Выберите артефакты и выберите веб-канал.

  3. Нажмите кнопку Значок шестеренки шестеренки, чтобы перейти к параметрам веб-канала.

  4. Выберите "Вышестоящий источник", а затем нажмите кнопку "Добавить вверх", чтобы добавить новый источник вышестоящий.

  5. Выберите общедоступный источник и выберите коллекцию NuGet в раскрывающемся меню.

  6. Нажмите кнопку "Сохранить " после завершения и нажмите кнопку "Сохранить еще раз" в правом верхнем углу, чтобы сохранить изменения.

Примечание.

Расположение индекса службы для nuget.org https://api.nuget.org/v3/index.json.

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

  1. Войдите в организацию Azure DevOps и перейдите к проекту.

  2. Выберите артефакты и выберите веб-канал.

  3. Выберите Подключение для канала и выберите NuGet.exe.

  4. Добавьте файл nuget.config в ту же папку, что и csproj или файл .sln. Вставьте предоставленный фрагмент XML в файл. Если вы используете приведенные ниже примеры, убедитесь, что заполнители заменяются соответствующими значениями для вашего сценария.

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

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

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

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

Теперь наш проект настроен для проверки подлинности с помощью нашего веб-канала, теперь можно перейти к установке пакетов из коллекции NuGet вышестоящий. В этом примере мы установим библиотеку журналов диагностики Serilog :

  1. Перейдите в коллекцию NuGet по адресу https://www.nuget.org/.

  2. Найдите пакет Serilog и выберите его, чтобы перейти на страницу сведений.

  3. Выберите вкладку диспетчер пакетов и скопируйте команду. В нашем примере команда выглядит следующим образом:

    NuGet\Install-Package Serilog -Version 3.1.2-dev-02097

  4. Откройте проект в Visual Studio, а затем выберите Сервис>NuGet диспетчер пакетов> диспетчер пакетов консоль, чтобы открыть окно консоли.

  5. Вставьте команду в окно консоли диспетчер пакетов и нажмите клавишу ВВОД, чтобы установить пакет.

Примечание.

Чтобы сохранить пакеты из вышестоящий, необходимо иметь роль веб-канала и средства чтения выше или выше. Дополнительные сведения см. в разделе Разрешения.

Просмотр сохраненных пакетов

  1. Войдите в организацию Azure DevOps и перейдите к проекту.

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

  3. Выберите источник коллекции NuGet из раскрывающегося меню, чтобы отфильтровать пакеты из этого вышестоящий.

  4. Пакет Serilog , установленный на предыдущем шаге, теперь доступен в нашем веб-канале. Артефакты Azure автоматически сохраняют копию в веб-канале при выполнении команды установки.

    Снимок экрана: пакет, сохраненный из вышестоящий.