Compartilhar via


PublishPipelineArtifact@1 - Tarefa Publicar Artefatos de Pipeline v1

Use essa tarefa para publicar (carregar) um arquivo ou diretório como um artefato nomeado para a execução atual.

Use essa tarefa para publicar (carregar) um arquivo ou diretório como um artefato nomeado para a execução atual.

Importante

Essa tarefa tem suporte apenas no Azure DevOps Services. Se você usá-lo no Servidor do Azure DevOps, receberá uma mensagem de erro semelhante a Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Usar Publicar Artefatos de Build se estiver usando o Servidor do Azure DevOps ou o TFS 2018.

Sintaxe

# Publish Pipeline Artifacts v1
# Publish (upload) a file or directory as a named artifact for the current run.
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path. Required. File or directory path. Default: $(Pipeline.Workspace).
    #artifact: # string. Alias: artifactName. Artifact name. 
    publishLocation: 'pipeline' # 'pipeline' | 'filepath'. Alias: artifactType. Required. Artifact publish location. Default: pipeline.
    #fileSharePath: # 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.
    #properties: # string. Custom properties.

Entradas

targetPath - caminho de arquivo ou diretório
Alias de entrada: path. string. Obrigatório Valor padrão: $(Pipeline.Workspace).

Especifica o caminho do arquivo ou diretório a ser publicado. Pode ser absoluto ou relativo ao diretório de trabalho padrão. Pode incluir variáveis , mas não há suporte para curingas. Consulte Artifacts no Azure Pipelines para obter mais informações.


de nome do artefato artifact -
Alias de entrada: artifactName. string.

Especifica o nome do artefato a ser publicado. Pode ser qualquer nome que você escolher, por exemplo, drop. Se não for definido, o padrão será uma ID exclusiva com escopo para o trabalho.

Importante

O nome do artefato não pode conter \, /, ", :, <, >, |, *ou ?.


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

Especifica se o artefato deve ser armazenado no Azure Pipelines ou copiá-lo para um compartilhamento de arquivos que deve estar acessível do agente de pipeline.


fileSharePath - caminho de compartilhamento de arquivos
string. Necessário quando artifactType = filepath.

Especifica o compartilhamento de arquivos em que os arquivos de artefato são copiados. Isso pode incluir variáveis, por exemplo, \\my\\share\\$(Build.DefinitionName)\\$(Build.BuildNumber). Não há suporte para a publicação de artefatos de um agente Linux ou macOS em um compartilhamento de arquivos, por exemplo, \\server\folderName.


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 thread será usado.


parallelCount - contagem paralela
string. Opcional. Use quando artifactType = filepath && parallel = true. Valor padrão: 8.

Especifica o grau de paralelismo ou o número de threads usados para executar a cópia. O valor deve estar entre 1 e 128.


properties - propriedades personalizadas
string.

Especifica as propriedades personalizadas a serem associadas ao artefato. Use uma cadeia de caracteres JSON válida com o prefixo user- em todas as chaves.


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

Não há suporte para publicação em pipelines de lançamento clássicos.

Observação

Não há suporte para a publicação de artefatos de pipeline no local. Use publicar artefatos de build se você estiver usando o Servidor do Azure DevOps ou o TFS 2018. Se você usá-lo no Servidor do Azure DevOps, receberá uma mensagem de erro semelhante a Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead..

As palavras-chave publish e download são atalhos para as tarefas PublishPipelineArtifact@1 e DownloadPipelineArtifact@2. Consulte steps.publish e steps.download para obter mais detalhes.

Dica

Você pode usar o arquivo .artifactignore para controlar quais arquivos serão publicados.

Estou tendo problemas com a publicação de meus artefatos. Como posso exibir os logs detalhados?

Para habilitar logs detalhados para o pipeline:

  1. Edite seu pipeline e selecione variáveis de
  2. Adicione uma nova variável com o nome System.Debug e o valor true
  3. Salvar

Quais variáveis estão disponíveis para mim?

R: $(Build.SourcesDirectory) e $(Agent.BuildDirectory) são apenas algumas das variáveis que você pode usar em seu pipeline. As variáveis estão disponíveis como expressões ou scripts.

Consulte Definir variáveis, variáveis predefinidase variáveis de lançamento e artefatos clássicos para saber mais sobre os diferentes tipos de variáveis.

A tarefa me permite publicar artefatos no trabalho de implantação no pipeline yaml, mas não consigo usá-la no pipeline downstream?

R: Os trabalhos de implantação não têm o contexto de branches de origem e, portanto, não são apropriados para publicação de artefatos. Eles foram projetados principalmente para consumir artefatos. Uma solução alternativa seria isolar essa lógica em um trabalho separado (com dependências em seus trabalhos de implantação).

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agente, 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 2.199.0 ou superior
Categoria de tarefa Utilidade
Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agente, 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 2.199 ou superior
Categoria de tarefa Utilidade

Consulte também