PublishBuildArtifacts@1 - Tarefa Publicar artefatos de compilação v1

Use esta tarefa em um pipeline de compilação para publicar artefatos de compilação no Azure Pipelines, TFS ou em um compartilhamento de arquivos.

Se você estiver usando os Serviços de DevOps do Azure, recomendamos usar Download Pipeline Artifacts e Publish Pipeline Artifacts para 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.

Insumos

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

Especifica o caminho da pasta ou do arquivo a ser publicado. Isso pode ser um caminho totalmente qualificado ou um caminho relativo à raiz do repositório. Não há suporte para curingas. Variáveis são suportadas. Exemplo: $(Build.ArtifactStagingDirectory). Para obter mais informações, consulte Artefatos em pipelines - visão geral.

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

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

publishLocation - 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 copiado para um compartilhamento de arquivos (FilePath) que deve ser acessível a partir do agente de compilação. O alias de entrada: ArtifactType é um nome alternativo para publishLocation e pode ser usado de forma intercambiável. Para obter mais informações, consulte artefactos 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 não quiser definir nenhum limite.

TargetPath - Caminho de compartilhamento de arquivos
string. Necessário quando ArtifactType = FilePath.

Especifica o caminho para o compartilhamento de arquivos onde você deseja copiar os arquivos. O caminho deve ser um caminho totalmente qualificado ou um caminho válido relativo 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 - 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 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 superior a 128. Escolha um valor com base nos recursos da CPU do agente de compilação.

StoreAsTar - alcatrão do artefato antes de carregá-
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 tarefa DownloadBuildArtifacts para extrair os itens baixados automaticamente. Essa configuração é ignorada nos agentes do Windows.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Observação

Não é possível usar Bin, App_Data e outros nomes de pasta reservados pelo IIS como um nome de artefato porque esse conteúdo não é servido 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

Requerimentos

Requisito	Descrição
Tipos de pipeline	YAML, construção clássica
Funciona em	Agente, DeploymentGroup
Exigências	Nenhum
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	1.91.0 ou superior
Categoria de tarefa	Utilidade

Ver também

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