PublishBuildArtifacts@1. Публикация артефактов сборки версии 1

Эта задача используется в конвейере сборки для публикации артефактов сборки в Azure Pipelines, TFS или общей папке.

Если вы используете Azure DevOps Services, рекомендуется использовать скачивание артефактов конвейера и публикации артефактов конвейера для повышения производительности.

Синтаксис

# 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.

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

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

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

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

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

publishLocation - расположение публикации артефакта
Псевдоним ввода: ArtifactType. string. Обязательное. Допустимые значения: Container (Azure Pipelines), FilePath (общая папка). Значение по умолчанию: Container.

Указывает, следует ли хранить артефакт в Azure Pipelines (контейнер) или копировать его в общую папку (FilePath), доступную агенту сборки. Псевдоним ввода: ArtifactType является альтернативным именем для publishLocation и может использоваться взаимозаменяемо. Дополнительные сведения см. в статье Артефакты в 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.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.

Выходные переменные

Нет.

Замечания

Примечание.

Нельзя использовать 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
требования	Нет
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	1.91.0 или больше
Категория задач	Полезность

См. также

• Справочник по шаблонам сопоставления файлов
• Как использовать эту задачу для публикации артефактов
• Узнайте, как использовать подробные журналы для устранения неполадок .