DownloadPipelineArtifact@1 — задача скачивания артефакта конвейера версии 1

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

Существует более новая версия этой задачи. Дополнительные сведения см. в разделе DownloadPipelineArtifact@2.

Примечание

Дополнительные сведения, включая команды Azure CLI, см. в статье Скачивание артефактов.

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

Важно!

Эта задача поддерживается только в Azure DevOps Services. Если вы используете его на Azure DevOps Server, вы получите сообщение об ошибке, аналогичное Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Использованию артефактов загрузки сборки, если вы используете Azure DevOps Server или TFS 2018.

Синтаксис

# Download Pipeline Artifacts v1
# Download a named artifact from a pipeline to a local path.
- task: DownloadPipelineArtifact@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.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).
# Download Pipeline Artifacts v1
# Download Pipeline Artifact.
- task: DownloadPipelineArtifact@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.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).

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

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

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


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

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


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

Идентификатор определения конвейера. В работающем конвейере definitionId можно найти в переменной System.DefinitionId . Также definitionId можно получить по URL-адресу на странице обзора конвейера на портале Azure DevOps. В следующем примере definitionId URL-адреса имеет значение 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Чтобы скачать артефакты из определенного определения конвейера, запишите definitionId из этого конвейера и укажите его в pipeline качестве параметра .


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

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


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

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


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

Указывает фильтр по имени ветви или ссылки. Например: refs/heads/develop.


pipelineId - Построить
Входной псевдоним: buildId. string. Требуется, если buildType == specific && buildVersionToDownload == specific.

Идентификатор запуска конвейера, из которого нужно скачать артефакты. В работающем конвейере buildId можно найти в переменной Build.BuildId . Также buildId можно получить по URL-адресу на странице сводки по запуску конвейера на портале Azure DevOps. В следующем примере buildId URL-адреса имеет значение 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Чтобы скачать артефакты из определенного запуска конвейера, запишите buildId из этого запуска и укажите его в buildId качестве параметра .


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

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


artifactName - Имя артефакта
string.

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


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

Шаблоны сопоставления файлов, ограничивающие скачанные файлы. Значением может быть один или несколько шаблонов сопоставления файлов, которые являются новыми разделителями строк. Дополнительные сведения о шаблонах сопоставления файлов.


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

Путь на компьютере агента, куда будут загружены артефакты.


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

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

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

Нет.

Remarks

Существует более новая версия этой задачи. Дополнительные сведения см. в разделе DownloadPipelineArtifact@2.

Важно!

Эта задача поддерживается только в Azure DevOps Services. Если вы используете его на Azure DevOps Server, вы получите сообщение об ошибке, аналогичное Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Использованию артефактов загрузки сборки, если вы используете Azure DevOps Server или TFS 2018.

По умолчанию артефакты скачиваются в $(Pipeline.Workspace). Если не указать имя артефакта, для каждого скачавшегося артефакта будет создан подкаталог. Вы можете использовать шаблоны сопоставления файлов , чтобы ограничить файлы, которые требуется скачать.

Как найти идентификатор конвейера, из которого нужно скачать артефакт?

Поиск definitionId для определенного определения конвейера

В работающем конвейере definitionId можно найти в переменной System.DefinitionId . Также definitionId можно получить по URL-адресу на странице обзора конвейера на портале Azure DevOps. В следующем примере definitionId URL-адреса имеет значение 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Чтобы скачать артефакты из определенного определения конвейера, запишите definitionId из этого конвейера и укажите его в pipeline качестве параметра .

Поиск buildId для определенного запуска конвейера

Идентификатор запуска конвейера, из которого нужно скачать артефакты. В работающем конвейере buildId можно найти в переменной Build.BuildId . Также buildId можно получить по URL-адресу на странице сводки по запуску конвейера на портале Azure DevOps. В следующем примере buildId URL-адреса имеет значение 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Чтобы скачать артефакты из определенного запуска конвейера, запишите buildId из этого запуска и укажите его в buildId качестве параметра .

Требования

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