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 для загрузки последнюю доступную версию сборки ветви, указанной с помощью branchNametags.
• Выберите 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/**.

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

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

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