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

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

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

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

Из этого краткого руководства вы узнаете, как выполнять следующие задачи:

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

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

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

• Установите последнюю версию NuGet.

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

Создание веб-канала

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

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

3. В поле "Имя" введите описательное имя веб-канала.

   Для видимости выберите параметр, чтобы указать, кто может просматривать пакеты в веб-канале.

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

   В области укажите, является ли область веб-канала проектом или организацией.

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

   

Примечание.

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

Подключение к веб-каналу

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

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

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

   

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

   

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

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

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

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

3. Выберите Visual Studio в левой области и скопируйте ИСХОДНЫй URL-адрес.

   

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

Windows

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

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

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

4. Если в веб-канале включены вышестоящий источник, снимите флажок nuget.org .

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

   

macOS

1. Создайте личный маркер доступа.

2. В Visual Studio в строке меню выберите параметры.

3. Выберите NuGet и выберите "Источники".

4. Выберите "Добавить и ввести имя веб-канала", исходный URL-адрес, имя пользователя (любая строка) и личный маркер доступа.

5. Нажмите кнопку "ОК ", чтобы сохранить источник.

6. Если в веб-канале включены вышестоящий источник, снимите флажок nuget.org .

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

   

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

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

2. Выберите "Обзор" и выберите веб-канал в раскрывающемся меню источника пакета.

   

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 можно использовать любое произвольное значение.

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

• Публикация пакетов NuGet с помощью Azure Pipelines (YAML/classic)
• Публикация пакетов в NuGet.org
• Использование пакетов из коллекции NuGet