PublishBuildArtifacts@1 – Publicera build artifacts v1-uppgift

Använd den här uppgiften i en bygg-pipeline 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 Hämta pipelineartefakter och Publicera pipelineartefakter för snabbare prestanda.

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.

Indata

PathtoPublish - Sökväg till publicering
string. Krävs. 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. Krävs. Standardvärde: drop.

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

publishLocation - Publiceringsplats för artefakt
Indataalias: ArtifactType. string. Krävs. Tillåtna värden: Container (Azure Pipelines), FilePath (En filresurs). Standardvärde: Container.

Anger om artefakten ska lagras i Azure Pipelines (Container) eller kopiera den till en filresurs (FilePath) som måste vara tillgänglig från byggagenten. Mer information finns i Artefakter i 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 - Sökväg till filresurs
string. Krävs när ArtifactType = FilePath.

Anger sökvägen till den filresurs 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 - Antal parallella
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 den laddas upp
boolean. Standardvärde: false.

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

Kontrollalternativ för aktivitet

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

Utdatavariabler

Inga.

Kommentarer

Anteckning

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 struktur för webbprojektmappar .

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
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	1.91.0 eller senare
Uppgiftskategori	Verktyg

Se även

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