Подключение веб-каналы Артефактов Azure (NuGet.exe)

  • Статья

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

Артефакты Azure позволяют разработчикам публиковать и скачивать пакеты NuGet из различных источников, включая веб-каналы и общедоступные реестры. Вы можете использовать частные веб-каналы Azure Artifacts для совместного использования пакетов с вашей командой или конкретными пользователями. Кроме того, вы можете создавать общедоступные веб-каналы, чтобы сделать пакеты общедоступными, что позволяет предоставлять им общий доступ к ним всем пользователям в Интернете. В этой статье описано, как подключиться к веб-каналу Артефактов Azure.

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

Настройка проекта

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

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

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

  4. Если вы впервые используете Azure Artifacts с NuGet.exe, убедитесь, что установлены необходимые компоненты, в противном случае выберите " Получить средства " в правом верхнем углу, чтобы установить их.

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

    • Веб-канал 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>

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

      <?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. Следуйте инструкциям в разделе "Настройка проекта", чтобы подключиться к веб-каналу.

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

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

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

  4. Следуйте приведенным инструкциям, чтобы добавить URL-адрес источника пакета в файл конфигурации nuget.config .

Внимание

Поставщик учетных данных Azure Artifacts требует NuGet 4.8.0.5385 или более поздней версии.

Для оптимальной производительности Azure Artifacts рекомендует использовать версию NuGet или более позднюю версию 5.5.x , так как она включает важные исправления ошибок, связанные с отменами и истечением времени ожидания.

Настройка устаревшего проекта

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

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

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

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

  4. Скопируйте исходный URL-адрес и замените /v3/index.json на /v2. Обновленный исходный URL-адрес должен выглядеть следующим образом:

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

      https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2

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

      https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2

  5. Создайте личный маркер доступа и убедитесь, что вы область его в правильную организацию, к которой вы хотите получить доступ, и выберите один из следующих область: Упаковка (чтение и запись) или Упаковка (чтение, запись и управление).

  6. Выполните следующую команду в окне командной строки, чтобы добавить источник веб-канала в файл nuget.config :

    nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <ANY_STRING_BUT_NOT_NULL> -password <YOUR_PERSONAL_ACCESS_TOKEN>

  7. Если ваша организация подключена к идентификатору Microsoft Entra, необходимо сначала пройти проверку подлинности с помощью учетных данных AD, а затем добавить личный маркер доступа с помощью команды setapikey :

    nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <AZURE_ACTIVE_DIRECTORY_USERNAME> -password <AZURE_ACTIVE_DIRECTORY_PASSWORD>

nuget setapikey <YOUR_PERSONAL_ACCESS_TOKEN> -source <SOURCE_URL>