Повышение уровня пакетов и управление представлениями веб-каналов в Azure Artifacts

  • Статья

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

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

По умолчанию Azure Artifacts поставляется с тремя представлениями: @Local, @Prerelease и @Release. @local— это представление по умолчанию, содержащее все опубликованные пакеты и все пакеты, сохраненные из вышестоящий источников. Все представления поддерживают NuGet, npm, Maven, Python и универсальные пакеты.

Примечание.

Артефакты Azure поддерживают только публикацию и восстановление пакетов из представления по умолчанию — @Local.

Повышение уровня пакетов

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

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

  3. Выберите пакет, который вы хотите повысить, и нажмите кнопку "Продвинуть".

    Снимок экрана: повышение уровня пакета в представление.

  4. Выберите представление из раскрывающегося меню и выберите "Повысить".

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

Примечание.

Понижение пакета не поддерживается. Если вы хотите, чтобы эта функция была добавлена в будущий выпуск, вы можете предложить функцию в Azure DevOps Сообщество разработчиков.

Повышение уровня пакетов с помощью REST API

Помимо использования пользовательского интерфейса Azure Artifacts, вы также можете повысить уровень пакетов с помощью REST API. Универсальный код ресурса (URI) зависит от типа пакета:

Используйте фактическое имя пользователя и версию пакета для {packageName} полей {packageVersion} соответственно. Если веб-канал область организации, опустите {project} поле.

Текст запроса — это документ с исправлениями JSON, добавляющий представление в конец массиваviews. Дополнительные сведения о взаимодействии с REST API и REST API см. в статье "Начало работы с REST API Azure DevOps".

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

    PATCH https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1-preview.1

  • Веб-канал область проекта:

    PATCH https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1-preview.1

    Используйте JsonPatchOperation для создания текста запроса. Дополнительные сведения см. в статье NuGet — обновление версии пакета.

  • Пример:
PATCH https://pkgs.dev.azure.com/fabrikam-fiber-inc/litware/_apis/packaging/feeds/litware-tools/nuget/packages/LitWare.Common/versions/1.0.0?api-version=5.1-preview.1 HTTP/1.1
Content-Type: application/json-patch+json

{
  "views": {
    "op": "add",
    "path": "/views/-",
    "value": "Release"
  }
}

Управление представлениями

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

Примечание.

Все представления веб-каналов в общедоступном проекте доступны всем пользователям в Интернете.

  1. Выберите Артефакты.

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

  3. Щелкните значок шестеренки, чтобы получить доступ к параметрам веб-канала.

    Снимок экрана: доступ к параметрам веб-канала.

  4. Выберите Представления.

    Снимок экрана: переход к представлениям.

  5. Выберите представление и нажмите кнопку "Изменить ", чтобы изменить представление или добавить представление , если вы хотите добавить новое представление.

  6. Выберите Сохранить, когда вы закончите.

Внимание

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