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

Utilize esta tarefa num pipeline de compilação para publicar artefactos de compilação nos Pipelines do Azure, no TFS ou numa partilha de ficheiros.

Se estiver a utilizar os Serviços de DevOps do Azure, recomendamos que utilize Transferir Artefactos de Pipeline e Publicar Artefactos de Pipeline para um desempenho mais rápido.

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.

Entradas

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

Especifica a pasta ou o caminho do ficheiro a publicar. Este pode ser um caminho completamente qualificado ou um caminho relativo à raiz do repositório. Não são suportados carateres universais. As variáveis são suportadas. Exemplo: $(Build.ArtifactStagingDirectory). Para obter mais informações, veja Artefactos em pipelines – descrição geral.

ArtifactName - Nome do artefacto
string. Obrigatório. Valor predefinido: drop.

Especifica o nome do artefacto a criar na localização de publicação. Não são permitidos os seguintes carateres especiais: +, %, , {, }

publishLocation - Localização de publicação de artefactos
Alias de entrada: ArtifactType. string. Obrigatório. Valores permitidos: Container (Pipelines do Azure), FilePath (Uma partilha de ficheiros). Valor predefinido: Container.

Especifica se pretende armazenar o artefacto nos Pipelines do Azure (Contentor) ou copiá-lo para uma partilha de ficheiros (FilePath) que tem de estar acessível a partir do agente de compilação. Para obter mais informações, veja Artefactos nos Pipelines do Azure.

MaxArtifactSize - Tamanho Máximo do Artefacto
string. Valor predefinido: 0.

Limite máximo do tamanho dos artefactos a publicar em bytes. Coloque 0 se não quiser definir qualquer limite.

TargetPath - Caminho da partilha de ficheiros
string. Necessário quando ArtifactType = FilePath.

Especifica o caminho para a partilha de ficheiros onde pretende copiar os ficheiros. O caminho tem de ser um caminho completamente qualificado ou um caminho válido em relação ao diretório de raiz do seu repositório. A publicação de artefactos de um agente Linux ou macOS para uma partilha de ficheiros não é suportada. Exemplo: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

Parallel - Cópia paralela
boolean. Opcional. Utilize quando ArtifactType = FilePath. Valor predefinido: false.

Especifica se deve copiar ficheiros em paralelo com vários threads para um maior débito potencial. Se esta definição não estiver ativada, será utilizado um único thread.

ParallelCount - Contagem paralela
string. Opcional. Utilize quando ArtifactType = FilePath && Parallel = true. Valor predefinido: 8.

Especifica o grau de paralelismo (o número de threads) utilizado para executar a cópia. O valor tem de ser, pelo menos, 1 e não superior a 128. Escolha um valor com base nas capacidades da CPU do agente de compilação.

StoreAsTar - Atar o artefacto antes de carregar
boolean. Valor predefinido: false.

Adiciona todos os ficheiros do caminho de publicação a um arquivo tar antes de carregar. Isto permite-lhe preservar as permissões de ficheiro UNIX. Utilize extractTars a opção da tarefaDownloadBuildArtifacts para extrair os itens transferidos automaticamente. Esta definiçã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, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Nota

Não pode utilizar Bin, App_Data e outros nomes de pastas reservados pelo IIS como um nome de Artefacto porque este conteúdo não é servido em resposta a pedidos Web. Veja 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	Description
Tipos de pipeline	YAML, Compilação clássica
É executado em	Agente, DeploymentGroup
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de tabelas definidas	Qualquer
Versão do agente	1.91.0 ou superior
Categoria da tarefa	Utilitário

Ver também

• Referência de padrões de correspondência de ficheiros
• Como devo proceder para utilizar esta tarefa para publicar artefactos
• Saiba como utilizar registos verbosos para resolução de problemas.