PublishBuildArtifacts@1 – Publicera build artifacts v1-uppgift

  • Artikel

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.

Använd den här uppgiften i en bygg-pipeline 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.

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

# Publish Build Artifacts v1
# Publish build artifacts to Azure Pipelines/TFS or a 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.

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.


publishLocation - Publiceringsplats för artefakt
Indataalias: ArtifactType. string. Krävs. Tillåtna värden: Container (Azure Pipelines/TFS) 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.


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

Skickar ytterligare alternativ till Robocopy-kommandot. Till exempel det rekursiva minimatchningsmönstret **/*.


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