PublishBuildArtifacts@1 – Publicera build artifacts v1-uppgift

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.

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 publishLocation = FilePath. File share path. 
    #Parallel: false # boolean. Optional. Use when publishLocation = FilePath. Parallel copy. Default: false.
    #ParallelCount: '8' # string. Optional. Use when publishLocation = FilePath && Parallel = true. Parallel count. Default: 8.
  # Advanced
    #StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.

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 publishLocation = 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 publishLocation = 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 publishLocation = 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.

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.