PublishBuildArtifacts@1 – Publicar a tarefa de compilação de artefatos v1

Use essa tarefa em um pipeline de build para publicar artefatos de build no Azure Pipelines, TFS ou um compartilhamento de arquivos.

Se você estiver usando o Azure DevOps Services, recomendamos usar Baixar artefatos de pipeline e publicar artefatos de pipeline para obter um desempenho mais rápido.

Sintaxe

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

Entradas

PathtoPublish - Caminho para publicar
string. Obrigatório Valor padrão: $(Build.ArtifactStagingDirectory).

Especifica a pasta ou o caminho do arquivo a ser publicado. Esse pode ser um caminho totalmente qualificado ou um caminho relativo à raiz do repositório. Não há suporte para curingas. variáveis têm suporte. Exemplo: $(Build.ArtifactStagingDirectory). Para obter mais informações, consulte Artifacts em pipelines – visão geral.

de nome do artefato ArtifactName -
string. Obrigatório Valor padrão: drop.

Especifica o nome do artefato a ser criado no local de publicação. Os seguintes caracteres especiais não são permitidos: +, %, {, }

publishLocation - o local de publicação do Artefato
Alias de entrada: ArtifactType. string. Obrigatório Valores permitidos: Container (Azure Pipelines), FilePath (um compartilhamento de arquivos). Valor padrão: Container.

Especifica se o artefato deve ser armazenado no Azure Pipelines (Contêiner) ou para copiá-lo para um compartilhamento de arquivos (FilePath) que deve ser acessível do agente de build. O alias de entrada: ArtifactType é um nome alternativo para publishLocation e pode ser usado de forma intercambiável. Para obter mais informações, consulte Artifacts no Azure Pipelines.

MaxArtifactSize - tamanho máximo do artefato
string. Valor padrão: 0.

Limite máximo do tamanho dos artefatos a serem publicados em bytes. Coloque 0 se você não quiser definir nenhum limite.

TargetPath - caminho de compartilhamento de arquivos
string. Obrigatório quando ArtifactType = FilePath.

Especifica o caminho para o compartilhamento de arquivos em que você deseja copiar os arquivos. O caminho deve ser um caminho totalmente qualificado ou um caminho válido em relação ao diretório raiz do repositório. Não há suporte para a publicação de artefatos de um agente Linux ou macOS em um compartilhamento de arquivos. Exemplo: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

Parallel - de cópia paralela
boolean. Opcional. Use quando ArtifactType = FilePath. Valor padrão: false.

Especifica se os arquivos devem ser copiados em paralelo usando vários threads para uma maior taxa de transferência potencial. Se essa configuração não estiver habilitada, um único thread será usado.

ParallelCount - contagem paralela
string. Opcional. Use quando ArtifactType = FilePath && Parallel = true. Valor padrão: 8.

Especifica o grau de paralelismo (o número de threads) usado para executar a cópia. O valor deve ser pelo menos 1 e não maior que 128. Escolha um valor com base nos recursos de CPU do agente de build.

StoreAsTar - tar o artefato antes de carregar
boolean. Valor padrão: false.

Adiciona todos os arquivos do caminho de publicação a um arquivo tar antes de carregar. Isso permite que você preserve as permissões de arquivo UNIX. Use extractTars opção da tarefaDownloadBuildArtifacts para extrair os itens baixados automaticamente. Essa configuração é ignorada em agentes do Windows.

Opções de controle de tarefa

Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Observações

Observação

Você não pode usar Bin, App_Data e outros nomes de pasta reservados pelo IIS como um nome de artefato porque esse conteúdo não é fornecido em resposta a solicitações da Web. Consulte ASP.NET estrutura de pastas do projeto Web para obter mais detalhes.

Exemplos

steps:
- task: CopyFiles@2
  inputs:
    contents: '_buildOutput/**'
    targetFolder: $(Build.ArtifactStagingDirectory)
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: $(Build.ArtifactStagingDirectory)
    artifactName: MyBuildOutputs

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico
Execuções em	Agent, DeploymentGroup
de demandas	Nenhum
recursos	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando	Qualquer
variáveis settable	Qualquer
Versão do agente	1.91.0 ou superior
Categoria de tarefa	Utilidade

Consulte também

• Referência de padrões de correspondência de arquivos
• Como posso usar essa tarefa para publicar artefatos
• Saiba como usar de logs detalhados para solução de problemas.