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.
# YAML Syntax is not supported in TFS 2018.
# Use the classic designer to add and configure tasks.
# See the following Inputs section for details on the inputs that this task supports.

Входные данные

PathtoPublish - Путь к публикации
string. Обязательный. Значение по умолчанию: $(Build.ArtifactStagingDirectory).

Указывает путь к папке или файлу для публикации. Это может быть полный путь или путь относительно корня репозитория. Подстановочные знаки не поддерживаются. Поддерживаются переменные . Например, $(Build.ArtifactStagingDirectory). Дополнительные сведения см. в статье Общие сведения об артефактах в конвейерах.


PathtoPublish - Путь к публикации
string. Обязательный.

Указывает путь к папке или файлу для публикации. Это может быть полный путь или путь относительно корня репозитория. Подстановочные знаки не поддерживаются. Поддерживаются переменные . Например, $(Build.ArtifactStagingDirectory). Дополнительные сведения см. в статье Общие сведения об артефактах в конвейерах.


ArtifactName - Имя артефакта
string. Обязательный. Значение по умолчанию: drop.

Указывает имя артефакта, создаваемого в расположении публикации. Не допускаются следующие специальные символы: +, %, {, . }


ArtifactName - Имя артефакта
string. Обязательный.

Указывает имя артефакта, создаваемого в расположении публикации.


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.


publishLocation - Расположение публикации артефакта
Входной псевдоним: ArtifactType. string. Обязательный. Допустимые значения: Container (Visual Studio Team Services/TFS), FilePath (общая папка).

Указывает, следует ли хранить артефакт в Azure Pipelines (контейнер) или копировать его в общую папку (FilePath), доступ к которому должен быть доступен из агента сборки. Дополнительные сведения см. в статье Артефакты в Azure Pipelines.


MaxArtifactSize - Максимальный размер артефакта
string. Значение по умолчанию: 0.

Максимальное ограничение на размер артефактов для публикации в байтах. Поместите 0, если вы не хотите устанавливать какие-либо ограничения.


TargetPath - Путь к общей папке
string. Требуется при .ArtifactType = FilePath

Указывает путь к общей папке, в которую требуется скопировать файлы. Путь должен быть полным или допустимым путем относительно корневого каталога репозитория. Публикация артефактов из агента Linux или macOS в общую папку не поддерживается. Например, \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).


TargetPath - Путь к общей папке
string. Необязательный элемент. Используйте при ArtifactType = FilePath. Значение по умолчанию: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

Указывает путь к общей папке, в которую требуется скопировать файлы. Путь должен быть полным или допустимым путем относительно корневого каталога репозитория. Публикация артефактов из агента 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
Требования Нет
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 1.91.0 или более поздней версии
Категория задач Служебная программа

См. также раздел