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

Краткое руководство. Начало работы с пакетами NuGet в Azure Artifacts

  • Статья

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

Артефакты Azure позволяют разработчикам публиковать и скачивать пакеты NuGet из источников, таких как веб-каналы и общедоступные реестры. С помощью артефактов Azure можно создавать веб-каналы, которые являются следующими:

  • Приватный, чтобы делиться пакетами с вашими коллегами и определенными пользователями.
  • Общедоступный, поэтому вы можете открыто делиться пакетами с любым пользователем в Интернете.

В этом кратком руководстве вы узнаете, как:

  • Создать новую ленту.
  • Настройте проект и подключитесь к ленте.
  • Публикация пакетов NuGet.
  • Скачайте пакеты из репозитория.

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

Создайте ленту

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

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

  3. Укажите имя для вашего веб-канала, выберите параметр Видимость, который определяет, кто может просматривать ваши пакеты; отметьте Включить пакеты из общих общедоступных источников, если вы хотите включить пакеты из источников, таких как nuget.org или npmjs.com; и для Областьрешите, должен ли канал быть ограничен вашим проектом или всей организацией.

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

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

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

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

  3. Укажите имя для вашего веб-канала, выберите параметр Видимость, который определяет, кто может просматривать ваши пакеты; отметьте Включить пакеты из общих общедоступных источников, если вы хотите включить пакеты из источников, таких как nuget.org или npmjs.com; и для Областьрешите, должен ли канал быть ограничен вашим проектом или всей организацией.

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

    Снимок экрана, показывающий выбор для создания новой ленты в Azure DevOps 2022.

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

    Снимок экрана: выбор для создания нового канала в Azure DevOps 2020.

Примечание.

По умолчанию новые созданные каналы имеют значение для службы Build Service проекта как Feed and Upstream Reader (Collaborator).

Подключение к фиду

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

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

  3. Выберите Подключиться к источнику, а затем выберите NuGet.exe в левой области. Если вы впервые используете Azure Artifacts с Nuget.exe, убедитесь, что установлены все необходимые компоненты.

    Снимок экрана: кнопка подключения к веб-каналу.

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

    Снимок экрана: инструкции по настройке проекта на экране.

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

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

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

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

    Снимок экрана: инструкции по настройке проекта NuGet в Azure DevOps Server 2020 и 2022.

Скачивание пакетов

1. Получение URL-адреса источника пакета

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

  2. Выберите Артефакты, выберите ваш канал в раскрывающемся меню, а затем выберите "Подключиться к каналу".

  3. Выберите Visual Studio в области навигации слева, а затем скопируйте URL-адрес источника.

    Снимок экрана, на котором показано, как найти URL-адрес источника веб-канала.

2. Настройка Visual Studio

  1. В Visual Studio выберите "Параметры>".

  2. Разверните раздел NuGet диспетчер пакетов и выберите "Источники пакетов".

  3. Введите значение имени веб-канала и URL-адрес источника, а затем нажмите зеленый знак плюса (+), чтобы добавить источник.

  4. Если вы включили вышестоящие источники в своем канале, снимите галочку nuget.org.

  5. По завершении щелкните ОК.

    Снимок экрана: выбор для настройки Visual Studio в Windows.

3. Скачивание пакетов

  1. В Visual Studio щелкните проект правой кнопкой мыши и выберите пункт "Управление пакетами NuGet".

  2. Выберите Обзор, а затем выберите ваш источник из раскрывающегося меню источника пакета.

    Снимок экрана: выбор источника пакета в Visual Studio.

  3. Используйте поисковую строку для поиска пакетов из вашего канала.

Примечание.

Использование обозревателя пакетов NuGet для поиска пакетов в вышестоящих источниках не поддерживается.

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

Чтобы опубликовать ваш пакет в вашем фиде, выполните следующую команду. Можно ввести любую строку для аргумента ApiKey .

nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>

Примеры:

  • Веб-канал с областью действия проекта:

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg

  • Веб-канал с областью действия организации:

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/_packaging/myFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg

Примечание.

Это ApiKey необходимо, но при публикации в каналы Azure Artifacts можно использовать любое произвольное значение.

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