Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте эту задачу для скачивания артефактов конвейера из предыдущих этапов этого конвейера или из другого конвейера.
Замечание
Дополнительные сведения, включая команды 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 v2
# Download build and pipeline artifacts.
- task: DownloadPipelineArtifact@2
inputs:
buildType: 'current' # 'current' | 'specific'. Alias: source. Required. Download artifacts produced by. Default: current.
#project: # string. Required when source == specific. Project.
#definition: # string. Alias: pipeline. Required when source == specific. Build pipeline.
#specificBuildWithTriggering: false # boolean. Alias: preferTriggeringPipeline. Optional. Use when source == specific. When appropriate, download artifacts from the triggering build. Default: false.
#buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Alias: runVersion. Required when source == specific. Build version to download. Default: latest.
#branchName: 'refs/heads/master' # string. Alias: runBranch. Required when source == specific && runVersion == latestFromBranch. Branch name. Default: refs/heads/master.
#pipelineId: # string. Alias: runId | buildId. Required when source == specific && runVersion == specific. Build.
#tags: # string. Optional. Use when source == specific && runVersion != specific. Build Tags.
#allowPartiallySucceededBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from partially succeeded builds. Default: false.
#allowFailedBuilds: false # boolean. Optional. Use when source == specific && runVersion != specific. Download artifacts from failed builds. Default: false.
#artifactName: # string. Alias: artifact. Artifact name.
#itemPattern: '**' # string. Alias: patterns. Matching patterns. Default: **.
targetPath: '$(Pipeline.Workspace)' # string. Alias: path | downloadPath. Required. Destination directory. Default: $(Pipeline.Workspace).
Входные данные
buildType
-
Скачивание артефактов, созданных
Псевдоним ввода: source.
string. Обязательное. Допустимые значения: current (текущий запуск), specific (конкретный запуск). Значение по умолчанию: current.
Загружает артефакты, созданные текущим запуском конвейера или с определенного запуска конвейера.
project
-
Проект
string. Обязательный, если source == specific.
Указывает имя проекта или GUID, из которого нужно скачать артефакты конвейера.
конвейера сборки definition -
Псевдоним ввода: pipeline.
string. Обязательный, если source == specific.
Идентификатор определения конвейера. В работающем конвейере definitionId можно найти в переменной System.DefinitionId.
definitionId также можно получить из URL-адреса на странице обзора конвейера на портале Azure DevOps. В следующем примере URL-адреса definitionId равно 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Чтобы скачать артефакты из определенного определения конвейера, захватить definitionId из этого конвейера и указать его в качестве параметра pipeline.
specificBuildWithTriggering
-
При необходимости скачайте артефакты из триггерной сборки.
Псевдоним ввода: preferTriggeringPipeline.
boolean. Необязательно. Используется при source == specific. Значение по умолчанию: false.
При проверке задача скачивает артефакты из запуска сборки. Если сборка не активируется из указанного конвейера, задача скачивает артефакты из сборки, указанной в приведенных ниже параметрах.
buildVersionToDownload
-
версия сборки для скачивания
Псевдоним ввода: runVersion.
string. Обязательный, если source == specific. Допустимые значения: latest, latestFromBranch (последняя из определенной ветви и указанные теги сборки), specific (конкретная версия). Значение по умолчанию: latest.
Указывает версию сборки для скачивания.
branchName
-
Имя ветви
Псевдоним ввода: runBranch.
string. Обязательный, если source == specific && runVersion == latestFromBranch. Значение по умолчанию: refs/heads/master.
Указывает фильтр в имени ветви или ссылки. Например: refs/heads/develop.
pipelineId
-
Сборка
Псевдоним ввода: runId | buildId.
string. Обязательный, если source == specific && runVersion == specific.
Идентификатор запуска конвейера, из которого необходимо скачать артефакты. В работающем конвейере buildId можно найти в переменной Build.BuildId.
buildId также можно получить из URL-адреса на странице сводки запуска конвейера на портале Azure DevOps. В следующем примере URL-адреса buildId равно 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Чтобы скачать артефакты из определенного запуска конвейера, захватить buildId из этого запуска и указать его в качестве параметра buildId.
tags
-
теги сборки
string. Необязательно. Используется при source == specific && runVersion != specific.
Список тегов с разделителями-запятыми, которые задача использует для возврата помеченных сборок. Неподключенные сборки не возвращаются.
allowPartiallySucceededBuilds
-
Скачайте артефакты из частично успешных сборок.
boolean. Необязательно. Используется при source == specific && runVersion != specific. Значение по умолчанию: false.
Указывает, следует ли скачивать артефакты из частично успешных сборок. Для этого необходимо задать и allowPartiallySucceededBuilds то, и allowFailedBuilds другое true.
allowFailedBuilds
-
Скачайте артефакты из неудачных сборок.
boolean. Необязательно. Используется при source == specific && runVersion != specific. Значение по умолчанию: false.
Указывает, следует ли скачивать артефакты из неудачных сборок.
имени артефакта artifactName -
Псевдоним ввода: artifact.
string.
Указывает имя артефакта для скачивания. Если значение остается пустым, задача скачивает все артефакты, связанные с выполнением конвейера.
itemPattern
-
Сопоставления шаблонов
Псевдоним ввода: patterns.
string. Значение по умолчанию: **.
Шаблоны сопоставления файлов, ограничивающие скачанные файлы. Значение может быть одним или несколькими шаблонами сопоставления файлов, которые являются новыми разделителями строк. Дополнительные сведения о шаблонах сопоставления файлов.
В отличие от других задач, эта задача скачает файл, соответствующий любому шаблону. Шаблоны исключения не могут использоваться для исключения ранее включенных файлов и будут включать файлы, которые не соответствуют ни одному из включенных шаблонов.
каталога назначения
Псевдоним ввода: path | downloadPath.
string. Обязательное. Значение по умолчанию: $(Pipeline.Workspace).
Указывает относительный или абсолютный путь на компьютере агента, где будут загружаться артефакты. Если применяется параметр многофакторной загрузки (оставив пустое имя артефакта), для каждой загрузки будет создан вложенный каталог. Дополнительные сведения о артефактах в Azure Pipelines.
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе "Параметры управления" и общие свойства задачи.
Выходные переменные
Эта задача определяет следующие выходные переменные, которые можно использовать в последующих шагах, заданиях и этапах.
BuildNumber
Сохраняет номер сборки источника артефакта конвейера.
Из-за обратной совместимости эта переменная возвращает BuildId.
Дополнительные сведения о переменных сборки.
Замечания
Это важно
Эта задача поддерживается только в 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 можно найти в переменной System.DefinitionId.
definitionId также можно получить из URL-адреса на странице обзора конвейера на портале Azure DevOps. В следующем примере URL-адреса definitionId равно 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Чтобы скачать артефакты из определенного определения конвейера, захватить definitionId из этого конвейера и указать его в качестве параметра pipeline.
Поиск идентификатора сборки для определенного запуска конвейера
Идентификатор запуска конвейера, из которого необходимо скачать артефакты. В работающем конвейере buildId можно найти в переменной Build.BuildId.
buildId также можно получить из URL-адреса на странице сводки запуска конвейера на портале Azure DevOps. В следующем примере URL-адреса buildId равно 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Чтобы скачать артефакты из определенного запуска конвейера, захватить buildId из этого запуска и указать его в качестве параметра buildId.
Примеры
Скачивание определенного артефакта
# Download an artifact named 'WebApp' to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
inputs:
artifactName: 'WebApp'
targetPath: $(Build.SourcesDirectory)/bin
Скачивание артефактов из определенного проекта или конвейера
# Download artifacts from a specific pipeline.
- task: DownloadPipelineArtifact@2
inputs:
buildType: 'specific'
project: 'FabrikamFiber'
definition: 12
buildVersionToDownload: 'latest'
Скачивание артефактов из определенной ветви
# Download artifacts from a specific branch with a tag
- task: DownloadPipelineArtifact@2
inputs:
buildType: 'specific'
project: 'FabrikamFiber'
definition: 12
buildVersionToDownload: 'latestFromBranch'
branchName: 'refs/heads/master'
tags: 'testTag'
Скачивание артефакта из определенного запуска сборки
# Download an artifact named 'WebApp' from a specific build run to 'bin' in $(Build.SourcesDirectory)
- task: DownloadPipelineArtifact@2
inputs:
buildType: 'specific'
artifactName: 'WebApp'
targetPath: $(Build.SourcesDirectory)/bin
project: 'FabrikamFiber'
definition: 12
buildVersionToDownload: 'specific'
pipelineId: 40
Требования
| Требование | Описание |
|---|---|
| Типы конвейеров | YAML, классическая сборка, классический выпуск |
| Выполняется в | Агент, DeploymentGroup |
| Требования | Отсутствует |
| Возможности | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
| Ограничения команд | Любое |
| Переменные settable | Любое |
| Версия агента | 2.164.1 или более поздней версии |
| Категория задач | Полезность |