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 или более поздней версии |
Категория задач | Служебная программа |