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

Статья
04/29/2024

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

Если вы используете 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 из-за обратной совместимости. Дополнительные сведения см. в разделе Переменные.

Требования

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