Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте эту задачу для скачивания артефактов конвейера из предыдущих этапов этого конвейера или из другого конвейера.
Существует более новая версия этой задачи. Дополнительные сведения см. в разделе DownloadPipelineArtifact@2.
Примечание.
Дополнительные сведения, включая команды Azure CLI, см. в скачивании артефактов.
Используйте эту задачу для скачивания артефактов конвейера из предыдущих этапов этого конвейера или из другого конвейера.
Существует более новая версия этой задачи. Дополнительные сведения см. в разделе 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).
Входные данные
buildType
-
Скачивание артефактов, созданных
string. Обязательное. Допустимые значения: current (текущая сборка), specific (конкретная сборка). Значение по умолчанию: current.
Загружает артефакты, созданные текущим запуском конвейера или с определенного запуска конвейера.
project
-
Проект
string. Требуется, если buildType == specific.
Указывает имя проекта или GUID, из которого нужно скачать артефакты конвейера.
конвейера сборки pipeline -
Псевдоним ввода: definition.
string. Требуется, если buildType == 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
-
При необходимости скачайте артефакты из триггерной сборки.
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. В следующем примере URL-адреса buildId равно 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. Значение по умолчанию: **.
Шаблоны сопоставления файлов, ограничивающие скачанные файлы. Значение может быть одним или несколькими шаблонами сопоставления файлов, которые являются новыми разделителями строк. Дополнительные сведения о шаблонах сопоставления файлов.
каталога назначения
Псевдоним ввода: downloadPath.
string. Обязательное. Значение по умолчанию: $(System.ArtifactsDirectory).
Путь на компьютере агента, в котором будут загружены артефакты.
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.
Выходные переменные
Нет.
Замечания
Существует более новая версия этой задачи. Дополнительные сведения см. в разделе 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 можно найти в переменной 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.
Требования
| Требование | Описание |
|---|---|
| Типы конвейеров | YAML, классическая сборка, классический выпуск |
| Выполняется в | Агент, DeploymentGroup |
| требования | Нет |
| возможностей | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
| ограничения команд | Любое |
| переменные settable | Любое |
| Версия агента | 2.155.1 или более поздней версии |
| Категория задач | Полезность |