Поделиться через

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

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

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

Предварительные условия

Продукт Требования
Azure DevOps — Организация Azure DevOps.
— проект Azure DevOps .
— канал Azure Artifacts .
— Скачайте и установите поставщик учетных данных Azure Artifacts.
— Установите последнюю версию NuGet.

Создание канала и включение вышестоящих источников

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

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

  2. Выберите Артефакты, затем выберите Создать канал.

  3. Укажите имя веб-канала, выберите параметр "Видимость ", чтобы определить, кто может просматривать пакеты и выбрать область. Azure Artifacts рекомендует ограничивать фиды для проекта, а не для всей организации.

  4. Обязательно проверьте вариант "Включить пакеты из общих общедоступных источников ", так как вам потребуется использовать пакеты из общедоступных реестров, таких как nuget.org, npmjs.com и т. д.

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

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

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

  1. Войдите в Azure DevOps и перейдите к проекту.

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

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

  1. Выберите "Вышестоящие источники", а затем "Добавить вышестоящий".

  2. Выберите общедоступный источник, выберите коллекцию NuGet в раскрывающемся меню и нажмите кнопку "Добавить".

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

Подключиться к вашей ленте новостей

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

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

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

  3. Выберите Подключиться к фиду, а затем выберите NuGet.exe.

  4. Убедитесь, что вы установили необходимые компоненты, а затем добавьте nuget.config файл в ту же папку, что и csproj или .sln-файл .

  5. Вставьте XML-фрагмент, предоставленный в разделе установки проекта в файл. Файл должен выглядеть следующим образом:

    • Канал в рамках проекта:

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

    • Лента, охватывающая всю организацию:

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

  1. Войдите в коллекцию Azure DevOps и перейдите к проекту.

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

  3. Выберите Подключиться к каналу, а затем выберите NuGet.exe на панели навигации слева.

  4. Следуйте инструкциям в разделе "Настройка проекта", чтобы подключиться к каналу.

Примечание.

Чтобы сохранить пакеты из вышестоящих источников, необходимо быть Читателем лент и источников (сотрудником) или выше. Дополнительные сведения см. в статье "Управление разрешениями ".

Теперь, когда проект настроен для проверки подлинности в веб-канале Azure Artifacts, можно перейти к установке пакетов из вышестоящей коллекции NuGet. В этом примере вы установите пакет SDK MCP C# для протокола контекста модели для приложений .NET для взаимодействия с клиентами и серверами MCP:

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

  2. Найдите ModelContextProtocol, а затем выберите его, чтобы открыть страницу сведений.

  3. Перейдите на вкладку .NET CLI и скопируйте команду. В этом примере команда:

    dotnet add package ModelContextProtocol --version 0.3.0-preview.4

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

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

Примечание.

Чтобы сохранять пакеты из источников, необходимо иметь роль "Чтение каналов и источников (Сотрудничество)" или выше. Дополнительные сведения см. в разделе " Роли и разрешения канала ".

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

  1. Войдите в Azure DevOps и перейдите к проекту.

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

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

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

    Снимок экрана: пакет MCP, сохраненный в веб-канале.

Связанный контент

  • Last updated on