DownloadBuildArtifacts@1 — задача "Скачать артефакты сборки версии 1"

Используйте эту задачу для скачивания файлов, сохраненных как артефакты завершенной сборки.

Если вы используете Azure DevOps Services, для повышения производительности рекомендуется скачать артефакты конвейера и опубликовать артефакты конвейера.

Синтаксис

# Download build artifacts v1
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@1
  inputs:
    buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when buildType == specific. Project. 
    #pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
    artifactName: # string. Required when downloadType == single. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
    #cleanDestinationFolder: false # boolean. Clean destination folder. Default: false.
  # Advanced
    #parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
    #checkDownloadedFiles: false # boolean. Check downloaded files. Default: false.
    #retryDownloadCount: '4' # string. Retry count. Default: 4.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

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

buildType - Скачивание артефактов, созданных
string. Обязательный. Допустимые значения: current (текущая сборка), specific (конкретная сборка). Значение по умолчанию: current.

Следует ли скачивать артефакты, созданные текущей сборкой или из определенной сборки.

project - Проекта
string. Требуется, если buildType == specific.

Проект, из которого нужно скачать артефакты сборки.

pipeline - Конвейер сборки
Входной псевдоним: definition. string. Требуется, если buildType == specific.

Указывает имя конвейера сборки.

specificBuildWithTriggering - При необходимости скачайте артефакты из запускающей сборки.
boolean. Необязательный элемент. Используйте при buildType == specific. Значение по умолчанию: false.

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

buildVersionToDownload - Версия сборки для скачивания
string. Требуется, если buildType == specific. Допустимые значения: latest, latestFromBranch (последняя из определенной ветви и указанных тегов сборки), specific (конкретная версия). Значение по умолчанию: latest.

Указывает версию сборки для скачивания.

• Выберите latest скачивание последней доступной версии сборки.
• Выберите latestFromBranch скачивание последней доступной версии сборки ветви, указанной в тегах branchName и с помощью tags.
• Выберите specific для скачивания версию сборки, указанную параметром buildId.

allowPartiallySucceededBuilds - Скачивать артефакты даже из частично успешных сборок.
boolean. Необязательный элемент. Используйте при buildType == specific && buildVersionToDownload != specific. Значение по умолчанию: false.

Если trueзадано значение , эта задача сборки пытается скачать артефакты, независимо от того, выполнена ли сборка успешно или частично.

branchName - Имя ветви
string. Требуется, если buildType == specific && buildVersionToDownload == latestFromBranch. Значение по умолчанию: refs/heads/master.

Указывает, следует ли выполнять фильтрацию по имени ветви или ссылки, например: refs/heads/develop.

buildId - Построить
string. Требуется, если buildType == specific && buildVersionToDownload == specific.

Сборка, из которой требуется скачать артефакты.

tags - Теги сборки
string. Необязательный элемент. Используйте при buildType == specific && buildVersionToDownload != specific.

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

downloadType - Тип загрузки
string. Обязательный. Допустимые значения: single (определенный артефакт), specific (определенные файлы). Значение по умолчанию: single.

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

• Выберите single (Конкретный артефакт), если требуется только один определенный артефакт, указанный параметром artifactName
• Выберите specific (Определенные файлы), если требуется все артефакты выбранной сборки

artifactName - Имя артефакта
string. Требуется, если downloadType == single.

Имя загружаемого артефакта.

itemPattern - Шаблон сопоставления
string. Значение по умолчанию: **.

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

Шаблон \*\* по умолчанию скачивает все файлы по всем артефактам в сборке, если выбран параметр Конкретные файлы . Чтобы скачать все файлы в перетаскиваемом артефакте, используйте .drop/**

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

Путь на компьютере агента, куда скачиваются артефакты.

cleanDestinationFolder - Очистить конечную папку
boolean. Значение по умолчанию: false.

Удалите все существующие файлы в конечной папке перед загрузкой артефакта.

parallelizationLimit - Ограничение параллелизации
string. Значение по умолчанию: 8.

Количество файлов для одновременной загрузки.

checkDownloadedFiles - Проверка скачанных файлов
boolean. Значение по умолчанию: false.

Если trueзадано значение , эта задача сборки проверяет, что все файлы полностью загружены.

retryDownloadCount - Число повторных попыток
string. Значение по умолчанию: 4.

Количество повторных попыток скачивания артефакта сборки в случае сбоя скачивания.

extractTars - Извлечение всех файлов, хранящихся в архивах TAR
boolean.

Задайте значение , true чтобы извлечь все скачанные файлы с расширением TAR . Это полезно, так как необходимо упаковать файлы артефактов в tar, если вы хотите сохранить разрешения для файлов Unix. StoreAsTar При включении параметра в задаче Публикация артефактов сборки артефакты будут автоматически сохраняться в виде TAR-файлов.

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

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

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

Эта задача определяет следующие выходные переменные, которые можно использовать в нисходящих шагах, заданиях и этапах.

BuildNumber
Хранит номер сборки источника артефакта сборки.

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

Комментарии

Примечание

Команда Azure Pipelines рекомендует обновить артефакты сборки до артефактов конвейера для повышения производительности.

Требования

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