PublishBuildArtifacts@1 - buildartefacten v1-taak publiceren

Gebruik deze taak in een build-pijplijn om buildartefacten te publiceren naar Azure Pipelines, TFS of een bestandsshare.

Als u Azure DevOps Services gebruikt, raden we u aan pijplijnartefacten te downloaden en pijplijnartefacten te publiceren voor snellere prestaties.

Syntaxis

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

Invoer

PathtoPublish - pad voor het publiceren van
string. Verplicht. Standaardwaarde: $(Build.ArtifactStagingDirectory).

Hiermee geeft u de map of het bestandspad om te publiceren. Dit kan een volledig gekwalificeerd pad of een pad zijn ten opzichte van de hoofdmap van de opslagplaats. Jokertekens worden niet ondersteund. variabelen worden ondersteund. Voorbeeld: $(Build.ArtifactStagingDirectory). Zie voor meer informatie Artefacten in pijplijnen - overzicht.

naam van ArtifactName - artefact
string. Verplicht. Standaardwaarde: drop.

Hiermee geeft u de naam op van het artefact dat moet worden gemaakt op de publicatielocatie. De volgende speciale tekens zijn niet toegestaan: +, %, {, }

publishLocation - locatie voor publiceren van artefacten
Invoeralias: ArtifactType. string. Verplicht. Toegestane waarden: Container (Azure Pipelines), FilePath (A-bestandsshare). Standaardwaarde: Container.

Hiermee geeft u op of het artefact moet worden opgeslagen in Azure Pipelines (Container) of dat het moet worden gekopieerd naar een bestandsshare (FilePath) die toegankelijk moet zijn vanuit de buildagent. De invoeralias: ArtifactType is een alternatieve naam voor publishLocation en kan door elkaar worden gebruikt. Zie Artifacts in Azure Pipelinesvoor meer informatie.

MaxArtifactSize - maximale grootte van artefacten
string. Standaardwaarde: 0.

Maximale limiet voor de grootte van artefacten die in bytes moeten worden gepubliceerd. Plaats 0 als u geen limiet wilt instellen.

TargetPath - bestandssharepad
string. Vereist wanneer ArtifactType = FilePath.

Hiermee geeft u het pad naar de bestandsshare waar u de bestanden wilt kopiëren. Het pad moet een volledig gekwalificeerd pad of een geldig pad zijn ten opzichte van de hoofdmap van uw opslagplaats. Het publiceren van artefacten van een Linux- of macOS-agent naar een bestandsshare wordt niet ondersteund. Voorbeeld: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

Parallel - parallel kopiëren
boolean. Facultatief. Gebruiken wanneer ArtifactType = FilePath. Standaardwaarde: false.

Hiermee geeft u op of bestanden parallel moeten worden gekopieerd met behulp van meerdere threads voor een grotere potentiële doorvoer. Als deze instelling niet is ingeschakeld, wordt één thread gebruikt.

ParallelCount - parallelle telling
string. Facultatief. Gebruiken wanneer ArtifactType = FilePath && Parallel = true. Standaardwaarde: 8.

Hiermee geeft u de mate van parallelle uitvoering (het aantal threads) dat wordt gebruikt om de kopie uit te voeren. De waarde moet ten minste 1 en niet groter zijn dan 128. Kies een waarde op basis van DE CPU-mogelijkheden van de buildagent.

StoreAsTar - Tar het artefact voordat u uploadt
boolean. Standaardwaarde: false.

Voegt alle bestanden van het publicatiepad toe aan een tar-archief voordat u uploadt. Hiermee kunt u de MACHTIGINGEN voor UNIX-bestanden behouden. Gebruik extractTars optie van deDownloadBuildArtifacts taak om de gedownloade items automatisch te extraheren. Deze instelling wordt genegeerd op Windows-agents.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Notitie

U kunt Bin-, App_Data en andere mapnamen die door IIS zijn gereserveerd, niet gebruiken als een artefactnaam omdat deze inhoud niet wordt geleverd als reactie op webaanvragen. Zie ASP.NET webmapstructuur voor meer informatie.

Voorbeelden

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

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	1.91.0 of hoger
Taakcategorie	Nutsvoorzieningen

Zie ook

• Naslaginformatie over bestandskoppelingspatronen
• Hoe gebruik ik deze taak om artefacten te publiceren
• Meer informatie over het gebruik van uitgebreide logboeken voor probleemoplossing.