DownloadBuildArtifacts@0. Загрузка артефактов сборки v0

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

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

Примечание.

Отключите обычную проверку подлинности IIS, если вы используете azure DevOps Server, чтобы разрешить проверку подлинности с помощью личного маркера доступа. Дополнительные сведения см. в базовой проверке подлинности IIS и PATs.

Синтаксис

# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
  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.
    #retryRedirectDownloadCount: '0' # string. Retry count for redirect download. Default: 0.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

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

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

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

project - Project
string. Требуется, если buildType == specific.

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

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

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

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

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

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

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.

Загружает определенный артефакт или определенные файлы из сборки.

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

Имя артефакта для скачивания.

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

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

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

.

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

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

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

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

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

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

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

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

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

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

retryRedirectDownloadCount - число повторных попыток для скачивания перенаправления
string. Значение по умолчанию: 0.

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

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

Извлекает все скачанные файлы с расширением .tar. Это полезно, так как необходимо упаковать файлы артефактов в файл .tar, если требуется сохранить разрешения на файлы Unix. Включение параметра StoreAsTar в задаче PublishBuildArtifacts сохраняет артефакты в виде .tar файлов автоматически.

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

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

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

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

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

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

Требования

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