PublishBuildArtifacts@1 — задача публикации артефактов сборки версии 1
Используйте эту задачу в конвейере сборки для публикации артефактов сборки в Azure Pipelines, TFS или в общей папке.
Если вы используете Azure DevOps Services, мы рекомендуем скачать артефакты конвейера и опубликовать артефакты конвейера для повышения производительности.
Используйте эту задачу в конвейере сборки для публикации артефактов сборки в Azure Pipelines, TFS или в общей папке.
Синтаксис
# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
inputs:
PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
#MaxArtifactSize: '0' # string. Max Artifact Size. Default: 0.
#TargetPath: # string. Required when ArtifactType = FilePath. File share path.
#Parallel: false # boolean. Optional. Use when ArtifactType = FilePath. Parallel copy. Default: false.
#ParallelCount: '8' # string. Optional. Use when ArtifactType = FilePath && Parallel = true. Parallel count. Default: 8.
# Advanced
#StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.
# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
inputs:
PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
#TargetPath: # string. Required when ArtifactType = FilePath. File share path.
#Parallel: false # boolean. Optional. Use when ArtifactType = FilePath. Parallel copy. Default: false.
#ParallelCount: '8' # string. Optional. Use when ArtifactType = FilePath && Parallel = true. Parallel count. Default: 8.
# Advanced
#FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options.
#StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.
# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
inputs:
PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
#TargetPath: # string. Required when ArtifactType = FilePath. File share path.
#Parallel: false # boolean. Optional. Use when ArtifactType = FilePath. Parallel copy. Default: false.
#ParallelCount: '8' # string. Optional. Use when ArtifactType = FilePath && Parallel = true. Parallel count. Default: 8.
# Advanced
#FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options.
# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
inputs:
PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
#TargetPath: # string. Required when ArtifactType = FilePath. File share path.
#Parallel: false # boolean. Optional. Use when ArtifactType = FilePath. Parallel copy. Default: false.
#ParallelCount: '8' # string. Optional. Use when ArtifactType = FilePath && Parallel = true. Parallel count. Default: 8.
# Publish Build Artifacts v1
# Publish build artifacts to Azure Pipelines/TFS or a file share.
- task: PublishBuildArtifacts@1
inputs:
PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
#TargetPath: # string. Required when ArtifactType = FilePath. File share path.
#Parallel: false # boolean. Optional. Use when ArtifactType = FilePath. Parallel copy. Default: false.
#ParallelCount: '8' # string. Optional. Use when ArtifactType = FilePath && Parallel = true. Parallel count. Default: 8.
Входные данные
PathtoPublish
- Путь к публикации
string
. Обязательный. Значение по умолчанию: $(Build.ArtifactStagingDirectory)
.
Указывает путь к папке или файлу для публикации. Это может быть полный путь или путь относительно корня репозитория. Подстановочные знаки не поддерживаются. Поддерживаются переменные . Например, $(Build.ArtifactStagingDirectory)
. Дополнительные сведения см. в статье Общие сведения об артефактах в конвейерах.
ArtifactName
- Имя артефакта
string
. Обязательный. Значение по умолчанию: drop
.
Указывает имя артефакта, создаваемого в расположении публикации. Не допускаются следующие специальные символы: +
, %
, {
, . }
publishLocation
- Расположение публикации артефакта
Входной псевдоним: ArtifactType
. string
. Обязательный. Допустимые значения: Container
(Azure Pipelines), FilePath
(общая папка). Значение по умолчанию: Container
.
Указывает, следует ли хранить артефакт в Azure Pipelines (контейнер) или копировать его в общую папку (FilePath), доступ к которому должен быть доступен из агента сборки. Дополнительные сведения см. в статье Артефакты в Azure Pipelines.
publishLocation
- Расположение публикации артефакта
Входной псевдоним: ArtifactType
. string
. Обязательный. Допустимые значения: Container
(Azure Pipelines/TFS), FilePath
(общая папка). Значение по умолчанию: Container
.
Указывает, следует ли хранить артефакт в Azure Pipelines (контейнер) или копировать его в общую папку (FilePath), доступ к которому должен быть доступен из агента сборки. Дополнительные сведения см. в статье Артефакты в Azure Pipelines.
MaxArtifactSize
- Максимальный размер артефакта
string
. Значение по умолчанию: 0
.
Максимальное ограничение на размер артефактов для публикации в байтах. Поместите 0, если вы не хотите устанавливать какие-либо ограничения.
TargetPath
- Путь к общей папке
string
. Требуется при .ArtifactType = FilePath
Указывает путь к общей папке, в которую требуется скопировать файлы. Путь должен быть полным или допустимым путем относительно корневого каталога репозитория. Публикация артефактов из агента Linux или macOS в общую папку не поддерживается. Например, \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber)
.
Parallel
- Параллельное копирование
boolean
. Необязательный элемент. Используйте при ArtifactType = FilePath
. Значение по умолчанию: false
.
Указывает, следует ли копировать файлы параллельно с помощью нескольких потоков для повышения потенциальной пропускной способности. Если этот параметр не включен, будет использоваться один поток.
ParallelCount
- Число параллельных операций
string
. Необязательный элемент. Используйте при ArtifactType = FilePath && Parallel = true
. Значение по умолчанию: 8
.
Указывает степень параллелизма (количество потоков), используемую для выполнения копирования. Значение должно быть не менее 1, а не больше 128. Выберите значение на основе возможностей ЦП агента сборки.
StoreAsTar
- Зафиксирование артефакта перед отправкой
boolean
. Значение по умолчанию: false
.
Добавляет все файлы из пути публикации в tar-архив перед отправкой. Это позволяет сохранить разрешения для файлов UNIX. Используйте extractTars
параметр задачиDownloadBuildArtifacts , чтобы автоматически извлечь скачанные элементы. Этот параметр не учитывается в агентах Windows.
FileCopyOptions
- Параметры копирования файлов
string
. Необязательный элемент. Используйте при ArtifactType = FilePath
.
Передает дополнительные параметры команде Robocopy. Например, рекурсивный шаблон **/*
мини-приложения .
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.
Выходные переменные
Нет.
Remarks
Примечание
Вы не можете использовать bin, App_Data и другие имена папок, зарезервированные IIS, в качестве имени артефакта, так как это содержимое не обслуживается в ответ на веб-запросы. Дополнительные сведения см . в ASP.NET структуре папок веб-проекта .
Примеры
steps:
- task: CopyFiles@2
inputs:
contents: '_buildOutput/**'
targetFolder: $(Build.ArtifactStagingDirectory)
- task: PublishBuildArtifacts@1
inputs:
pathToPublish: $(Build.ArtifactStagingDirectory)
artifactName: MyBuildOutputs
Требования
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка |
Выполняется в | Агент, DeploymentGroup |
Требования | None |
Capabilities | Эта задача не удовлетворяет требованиям для последующих задач в задании. |
Ограничения команд | Любой |
Устанавливаемые переменные | Любой |
Версия агента | 1.91.0 или более поздней версии |
Категория задач | Служебная программа |