PublishPipelineArtifact@1 – Publicera pipelineartefakt 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.

Indata

targetPath - Fil- eller katalogsökväg
Indataalias: path. string. Krävs. 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 vilket namn du vill, 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 - Publiceringsplats för artefakt
Indataalias: artifactType. string. Krävs. Tillåtna värden: pipeline (Azure Pipelines), filepath (En filresurs). Standardvärde: pipeline.

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

fileSharePath - Sökväg till filresurs
string. Krävs när artifactType = filepath.

Anger den filresurs 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 - Antal parallella
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.

Kontrollalternativ för aktivitet

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

Utdatavariabler

Inga.

Kommentarer

Publicering stöds inte i klassiska versionspipelines.

Anteckning

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 .artifactignore-filen för att styra vilka filer som ska publiceras.

Jag har problem med att publicera mina artefakter. Hur visar jag 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 namn System.Debug och värde 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 din pipeline. Variabler är tillgängliga som uttryck eller skript.

Mer information om de olika typerna av variabler finns i Definiera variabler, fördefinierade variabler och variabler för klassisk version och artefakter .

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

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 är att isolera 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
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	2.199.0 eller senare
Uppgiftskategori	Verktyg

Se även

• Vill du komma igång med byggartefakter? Se Artefakter i Azure Pipelines.