PublishBuildArtifacts@1 – Publicera build artifacts v1-uppgift

2025-10-07

Använd den här uppgiften i en byggpipeline för att publicera byggartefakter till Azure Pipelines, TFS eller en filresurs.

Om du använder Azure DevOps Services rekommenderar vi att du använder Ladda ned pipelineartefakter och Publicera pipelineartefakter för snabbare prestanda.

Använd den här uppgiften i en byggpipeline för att publicera byggartefakter till Azure Pipelines, TFS eller en filresurs.

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.

Ingångar

PathtoPublish - sökväg för att publicera
string. Obligatoriskt. Standardvärde: $(Build.ArtifactStagingDirectory).

Anger den mapp eller filsökväg som ska publiceras. Detta kan vara en fullständigt kvalificerad sökväg eller en sökväg i förhållande till lagringsplatsens rot. Jokertecken stöds inte. variabler stöds. Exempel: $(Build.ArtifactStagingDirectory). Mer information finns i Artefakter i pipelines – översikt.

ArtifactName - Artefaktnamn
string. Obligatoriskt. Standardvärde: drop.

Anger namnet på artefakten som ska skapas på publiceringsplatsen. Följande specialtecken tillåts inte: +, %, {, }

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

Anger om artefakten ska lagras i Azure Pipelines (Container) eller om den ska kopieras till en filresurs (FilePath) som måste vara tillgänglig från byggagenten. Indataaliaset: ArtifactType är ett alternativt namn för publishLocation och kan användas omväxlande. Mer information finns i Artifacts in Azure Pipelines.

MaxArtifactSize - maximal artefaktstorlek
string. Standardvärde: 0.

Maximal gräns för storleken på artefakter som ska publiceras i byte. Ange 0 om du inte vill ange någon gräns.

TargetPath - Filresurssökväg
string. Krävs när ArtifactType = FilePath.

Anger sökvägen till filresursen där du vill kopiera filerna. Sökvägen måste vara en fullständigt kvalificerad sökväg eller en giltig sökväg i förhållande till lagringsplatsens rotkatalog. Det går inte att publicera artefakter från en Linux- eller macOS-agent till en filresurs. Exempel: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

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 enda tråd.

ParallelCount - Parallellt antal
string. Valfritt. Använd när ArtifactType = FilePath && Parallel = true. Standardvärde: 8.

Anger graden av parallellitet (antalet trådar) som används för att utföra kopian. Värdet måste vara minst 1 och inte större än 128. Välj ett värde baserat på processorfunktionerna i byggagenten.

StoreAsTar - Tar artefakten innan du laddar upp
boolean. Standardvärde: false.

Lägger till alla filer från publiceringssökvägen till ett tjärarkiv innan du laddar upp. På så sätt kan du behålla UNIX-filbehörigheterna. Använd extractTars alternativet förDownloadBuildArtifacts uppgift för att extrahera de nedladdade objekten automatiskt. Den här inställningen ignoreras på Windows-agenter.

FileCopyOptions - Alternativ för filkopiering
string. Valfritt. Använd när ArtifactType = FilePath.

Skickar ytterligare alternativ till Robocopy-kommandot. Det rekursiva minimatchmönstret **/*till exempel .

Kontrollalternativ för aktivitet

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

Utdatavariabler

Ingen.

Anmärkningar

Anmärkning

Du kan inte använda Bin, App_Data och andra mappnamn som reserverats av IIS som artefaktnamn eftersom det här innehållet inte hanteras som svar på webbbegäranden. Mer information finns i ASP.NET mappstruktur för webbprojekt.

Exempel

steps:
- task: CopyFiles@2
  inputs:
    contents: '_buildOutput/**'
    targetFolder: $(Build.ArtifactStagingDirectory)
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: $(Build.ArtifactStagingDirectory)
    artifactName: MyBuildOutputs

Krav

Krav	Beskrivning
Pipelinetyper	YAML, 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	1.91.0 eller senare
Aktivitetskategori	Nytta

Se även

Referens för filmatchningsmönster
Hur använder jag den här uppgiften för att publicera artefakter
Lär dig hur du använder utförliga loggar för felsökning.

Feedback

Var den här sidan till hjälp?