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.
# 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'. 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
, pypi
nuget
(Python), upack
(универсальный), cargo
. Значение по умолчанию: nuget
.
packageType
- Тип пакета
string
. Обязательный. Допустимые значения: maven
, npm
, pypi
nuget
(Python), upack
(универсальный). Значение по умолчанию: 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 или более поздней версии |
Категория задач | Служебная программа |
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка, классический выпуск |
Выполняется в | Агент, DeploymentGroup |
Требования | Нет |
Capabilities | Эта задача не удовлетворяет требованиям для последующих задач в задании. |
Ограничения команд | Любой |
Устанавливаемые переменные | Любой |
Версия агента | 2.115.0 или более поздней версии |
Категория задач | Служебная программа |