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

Статья
07/02/2024

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

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

Примечание

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

Скачайте артефакты сборки.

Синтаксис

# 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.

# 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.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

# 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).
  # Advanced
    #parallelizationLimit: '8' # string. Parallelization limit. Default: 8.

# Download Build Artifacts v0
# Download Build Artifacts.
- 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.
    #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).
  # Advanced
    #parallelizationLimit: '8' # string. Parallelization limit. Default: 8.

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

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.

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/**

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

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

Требования

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

Поделиться через