DownloadPackage@1 — задача "Скачать пакет версии 1"

Используйте эту задачу, чтобы скачать пакет из веб-канала управления пакетами в Azure Artifacts.

Синтаксис

# Download package v1
# Download a package from a package management feed in Azure Artifacts.
- task: DownloadPackage@1
  inputs:
    packageType: 'nuget' # 'maven' | 'npm' | 'nuget' | 'pypi' | 'upack' | 'cargo'. Required. Package Type. Default: nuget.
    feed: # string. Required. Feed. 
    #view: # string. View. 
    definition: # string. Required. Package. 
    version: # string. Required. Version. 
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
  # Advanced
    #files: '**' # string. Optional. Use when packageType = maven || packageType = pypi || packageType = upack. Files. Default: **.
    #extract: true # boolean. Optional. Use when packageType = nuget || packageType = npm. Extract package contents. Default: true.

Входные данные

packageType - Тип пакета
string. Обязательный. Допустимые значения: maven, npm, pypinuget(Python), upack (универсальный), cargo. Значение по умолчанию: nuget.

feed - Кормить
string. Обязательный.

Для веб-каналов с областью проекта используется projectID/feedIDформат . Ознакомьтесь со следующими примечаниями , чтобы узнать, как получить идентификатор веб-канала или проекта, а также о том, как вместо этого использовать проект и имя канала.

view - Вид
string.

Указывает представление, в котором используются только версии, которые были повышены до определенного представления.

definition - Пакет
string. Обязательный.

Если вы не нашли пакет в списке, вы можете указать идентификатор пакета, который можно найти с помощью инструкций здесь.

version - Версия
string. Обязательный.

Указывает версию пакета. Используйте для latest скачивания последней версии пакета во время выполнения.

files - Файлы
string. Необязательный элемент. Используйте при packageType = maven || packageType = pypi || packageType = upack. Значение по умолчанию: **.

Указывает, какие файлы следует скачивать с помощью шаблонов сопоставления файлов.

extract - Извлечение содержимого пакета
boolean. Необязательный элемент. Используйте при packageType = nuget || packageType = npm. Значение по умолчанию: true.

Извлекает содержимое пакета и содержит архив пакета в папке артефактов.

downloadPath - Целевой каталог
string. Обязательный. Значение по умолчанию: $(System.ArtifactsDirectory).

Указывает путь на компьютере агента, куда скачан пакет.

Параметры управления задачами

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

Выходные переменные

Нет.

Remarks

Используйте эту задачу, чтобы скачать пакет из веб-канала управления пакетами в Azure Artifacts или TFS.

Примечание

Требуется расширение управления пакетами.

Разделы справки найти идентификатор веб-канала (или проекта), из которого нужно скачать артефакт

API получения веб-канала можно использовать для получения веб-канала и идентификатора проекта для веб-канала. Api описан здесь.

Можно ли использовать имя проекта или веб-канала вместо идентификаторов

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

Примеры

Скачивание пакета NuGet из веб-канала с областью организации и извлечение в целевой каталог

# Download an artifact with id 'cfe01b64-ded4-47b7-a569-2ac17cbcedbd' to $(System.ArtifactsDirectory)
- task: DownloadPackage@1
  inputs:
    packageType: 'nuget'
    feed: '6a60ef3b-e29f-41b6-9885-7874278baac7'
    definition: 'cfe01b64-ded4-47b7-a569-2ac17cbcedbd' # Can also be package name
    version: '1.0.0'
    extract: true
    downloadPath: '$(System.ArtifactsDirectory)'

Скачивание пакета Maven из веб-канала с областью проекта и скачивание только POM-файлов

# Download an artifact with name 'com.test:testpackage' to $(System.ArtifactsDirectory)
- task: DownloadPackage@1
  inputs:
    packageType: 'maven'
    feed: '132f5c2c-2aa0-475a-8b47-02c79617954b/c85e5de9-7b12-4cfd-9293-1b33cdff540e' # <projectId>/<feedId>
    definition: 'com.test:testpackage' 
    version: '1.0.0-snapshot' # Should be normalized version
    files: '*.pom'
    downloadPath: '$(System.ArtifactsDirectory)'

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
Требования	Нет
Capabilities	Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд	Любой
Устанавливаемые переменные	Любой
Версия агента	2.144.0 или более поздней версии
Категория задач	Служебная программа