Публикация и скачивание универсальных пакетов

с помощью универсальных пакетов пользователи могут хранить разные типы пакетов, кроме широко используемых, таких как NuGet, npm, Maven или пакеты Python. Размер передаваемых пакетов может быть разным (протестирован до 4 ТБ), но всегда должен иметь имя и номер версии. Вы можете публиковать и скачивать универсальные пакеты из командной строки с помощью Azure CLI.

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

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

  1. Скачайте и установите последнюю версию Azure CLI .
  2. Если вы используете Linux, убедитесь, что у вас установлена соответствующая версия .NET в Linux .

Чтобы проверить версию модулей Azure CLI и расширений, установленных в настоящее время, выполните следующую команду:

az --version

вы можете установить расширение Azure DevOps с помощью следующей команды:

az extension add --name azure-devops

если у вас уже есть расширение Azure DevOps но вы хотите обновить его до последней версии, выполните следующую команду:

az extension update --name azure-devops

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

Веб-канал — это организационная конструкция, позволяющая хранить пакеты и управлять ими, а также управлять доступом к ним.

  1. В проекте перейдите к Azure Artifacts.

    Переход к Azure Artifacts

  2. Выберите создать веб-канал.

    Кнопка

  3. Присвойте веб-каналу имя и выберите его видимость, вышестоящий источники параметры области .

    Диалоговое окно нового веб-канала

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

Azure Artifacts устанавливается по умолчанию для клиентов TFS 2017. Чтобы использовать Azure Artifacts, необходимо выполнить обновление до TFS 2017. Если веб-канал используется впервые, вам может быть предложено назначить лицензию .

  1. Перейдите в раздел Build Release (сборка выпуска ) и выберите пакеты.

    Переход к Azure Artifacts TFS

  2. Выберите + создать веб-канал.

    Новая кнопка веб-канала TFS

  3. Присвойте веб-каналу имя, Описаниеи настройте, кто может читать, кто может участвовать в программе , и если вы хотите включить внешние пакеты.

    Диалоговое окно

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

Вход в Azure DevOps

После установки Azure CLI выполните следующую команду в окне командной строки с повышенными привилегиями, чтобы войти в Azure. Замените текст в квадратных скобках [] соответствующими именами.

az login

Совет

Чтобы получить доступ к клиентам без подписок, выполните команду az login --allow-no-subscription .

Затем задайте свой проект и организацию в качестве интерфейса командной строки по умолчанию.

az devops configure --defaults organization=https://dev.azure.com/[your-organization] project=[your-project-name]

Публикация универсального пакета

Теперь мы можем использовать az artifacts universal команду для управления универсальными пакетами. В следующем примере мы будем публиковать Мой-First-Packageверсии 1.0.0 в FabrikamFiber в организации Fabrikam . Фибрикамфибер — это веб-канал на уровне Организации.

Имена пакетов должны быть строчными и могут содержать только буквы, цифры и тире. Версии пакета должны быть строчными без метаданных сборки (+ суффикс). Дополнительные сведения об семантическом управлении версиями см. в разделе SemVer .

az artifacts universal publish --organization https://dev.azure.com/Fabrikam --feed FabrikamFiber --name my-first-package --version 1.0.0 --description "My first universal package" --path .

Просмотр пакета в веб-канале

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

Просмотр опубликованного универсального пакета

Загрузка универсального пакета

Теперь, когда вы опубликовали первый универсальный пакет, давайте попробуем скачать его с помощью Azure CLI. В следующем примере будет скачан пакет, который мы опубликовали ранее.

az artifacts universal download --organization https://dev.azure.com/Fabrikam --feed FabrikamFiber --name my-first-package --version 1.0.0 --path .

Примечание

Azure DevOps не поддерживает прямые ссылки для скачивания по протоколу HTTP/HTTPS.

Загрузка определенных файлов

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

Следующий пример *logs/*.log соответствует любому файлу, конечному с *logs/*.log , и с расширением . log. Пример: build123_logs. log

Дополнительные сведения см. в разделе Справочник по шаблонам сопоставления файлов .

az artifacts universal download --organization https://dev.azure.com/fabrikam --feed FabrikamFiber --name my-first-package --version 1.0.0 --path .  --file-filter *logs/*.log

Скачивание последней версии

Для скачивания последней версии Universal Packages можно использовать подстановочные знаки.

Синтаксис

--Version-v: версия пакета, например "2.1.0".

Примеры:

  • --version *— Последняя версия.

  • --version 1.*: Последняя версия с номером 1.

  • --version 1.2.*: последний выпуск исправлений с основными 1 и дополнительными 2.

Примечание

Подстановочные знаки не поддерживаются в предварительной версии.