tarefa PublishBuildArtifacts@1 – Publicar artefatos de build v1

  • Artigo

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

Se você estiver usando Azure DevOps Services, recomendamos usar Baixar Artefatos de Pipeline e Publicar Artefatos de Pipeline para obter um desempenho mais rápido.

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

Syntax

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

Entradas

PathtoPublish - Caminho a ser publicado
string. Obrigatórios. Valor padrão: $(Build.ArtifactStagingDirectory).

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


ArtifactName - Nome do artefato
string. Obrigatórios. 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 - Local de publicação do artefato
Alias de entrada: ArtifactType. string. Obrigatórios. 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 copiá-lo para um compartilhamento de arquivos (FilePath) que deve estar acessível a partir do agente de build. Para obter mais informações, confira Artefatos no Azure Pipelines.


publishLocation - Local de publicação do artefato
Alias de entrada: ArtifactType. string. Obrigatórios. Valores permitidos: Container (Azure Pipelines/TFS), FilePath (um compartilhamento de arquivos). Valor padrão: Container.

Especifica se o artefato deve ser armazenado no Azure Pipelines (Contêiner) ou copiá-lo para um compartilhamento de arquivos (FilePath) que deve estar acessível a partir do agente de build. Para obter mais informações, confira Artefatos no Azure Pipelines.


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

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


TargetPath - Caminho do 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 - 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 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 preservar as permissões de arquivo UNIX. Use extractTars a opção da tarefaDownloadBuildArtifacts para extrair os itens baixados automaticamente. Essa configuração é ignorada em agentes do Windows.


FileCopyOptions - Opções de cópia de arquivo
string. Opcional. Use quando ArtifactType = FilePath.

Passa opções adicionais para o comando Robocopy. Por exemplo, o padrão minimatch recursivo **/*.


Opções de controle da tarefa

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

Variáveis de saída

Nenhum.

Comentários

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. Confira Estrutura de Pastas do Projeto Web ASP.NET 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
É executado em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 1.91.0 ou superior
Categoria da tarefa Utilitário

Confira também