PublishPipelineArtifact@1 – Publicera pipelineartefakter v1-uppgift

Använd den här uppgiften för att publicera (ladda upp) en fil eller katalog som en namngiven artefakt för den aktuella körningen.

Syntax

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

Ingångar

targetPath - fil- eller katalogsökväg
Indataalias: path. string. Obligatoriskt. Standardvärde: $(Pipeline.Workspace).

Anger sökvägen till filen eller katalogen som ska publiceras. Kan vara absolut eller i förhållande till standardarbetskatalogen. Kan innehålla variabler, men jokertecken stöds inte. Mer information finns i Artefakter i Azure Pipelines.

artifact - Artefaktnamn
Indataalias: artifactName. string.

Anger namnet på artefakten som ska publiceras. Det kan vara valfritt namn som du väljer, till exempel drop. Om det inte anges är standardvärdet ett unikt ID som är begränsat till jobbet.

Viktigt!

Artefaktnamnet får inte innehålla \, /, ", :, <, >, |, *eller ?.

publishLocation - Artefaktpublicera plats
Indataalias: artifactType. string. Obligatoriskt. Tillåtna värden: pipeline (Azure Pipelines), filepath (en filresurs). Standardvärde: pipeline.

Anger om artefakten ska lagras i Azure Pipelines eller kopiera den till en filresurs som måste vara tillgänglig från pipelineagenten.

fileSharePath - Filresurssökväg
string. Krävs när artifactType = filepath.

Anger filresursen där artefaktfilerna kopieras. Detta kan omfatta variabler, till exempel \\my\\share\\$(Build.DefinitionName)\\$(Build.BuildNumber). Det går inte att publicera artefakter från en Linux- eller macOS-agent till en filresurs, till exempel \\server\folderName.

parallel - Parallellkopiering
boolean. Valfritt. Använd när artifactType = filepath. Standardvärde: false.

Anger om filer ska kopieras parallellt med flera trådar för större potentiellt dataflöde. Om den här inställningen inte är aktiverad används en tråd.

parallelCount - Parallellt antal
string. Valfritt. Använd när artifactType = filepath && parallel = true. Standardvärde: 8.

Anger graden av parallellitet, eller antalet trådar som används, för att utföra kopian. Värdet måste vara mellan 1 och 128.

properties - Anpassade egenskaper
string.

Anger de anpassade egenskaper som ska associeras med artefakten. Använd en giltig JSON-sträng med prefixet user- på alla nycklar.

Alternativ för aktivitetskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Publicering stöds inte i klassiska versionspipelines.

Anmärkning

Publicera pipelineartefakter stöds inte lokalt. Använd Publicera byggartefakter om du använder Azure DevOps Server eller TFS 2018. Om du använder den på Azure DevOps Server får du ett felmeddelande som liknar Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead..

Nyckelorden publish och download är genvägar för PublishPipelineArtifact@1 och DownloadPipelineArtifact@2 uppgifter. Mer information finns i steps.publish och steps.download.

Tips

Du kan använda filen .artifactignore för att styra vilka filer som ska publiceras.

Jag har problem med att publicera mina artefakter. Hur kan jag visa de detaljerade loggarna?

Så här aktiverar du detaljerade loggar för din pipeline:

1. Redigera din pipeline och välj variabler
2. Lägg till en ny variabel med namnet System.Debug och värdet true
3. Spara

Vilka variabler är tillgängliga för mig?

S: $(Build.SourcesDirectory) och $(Agent.BuildDirectory) är bara några av de variabler som du kan använda i pipelinen. Variabler är tillgängliga som uttryck eller skript.

Se Definiera variabler, fördefinierade variableroch klassiska versions- och artefaktervariabler för att lära dig mer om de olika typerna av variabler.

Med uppgiften kan jag publicera artefakter i distributionsjobbet i yaml-pipelinen, men jag kan inte använda den i en nedströmspipeline?

S: Distributionsjobb har inte kontexten för källgrenar och är därför inte lämpliga för publicering av artefakter. De har främst utformats för att använda artefakter. En lösning skulle vara att isolera den logiken till ett separat jobb (med beroenden för dina distributionsjobb).

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	2.199.0 eller senare
Aktivitetskategori	Nytta

Se även

• Vill du komma igång med att skapa artefakter? Se Artefakter i Azure Pipelines.