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


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

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

Существует более новая версия этой задачи. Дополнительные сведения см. в разделе 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 или более поздней версии
Категория задач Полезность