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 downloaden te gebruiken en Pijplijnartefacten te publiceren voor snellere prestaties.

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.

Invoerwaarden

PathtoPublish - Pad om te publiceren
string. Vereist. Standaardwaarde: $(Build.ArtifactStagingDirectory).

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

ArtifactName - Naam van artefact
string. Vereist. 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 - Publicatielocatie van artefact
Invoeralias: ArtifactType. string. Vereist. Toegestane waarden: Container (Azure Pipelines), FilePath (een 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. Zie Artefacten in Azure Pipelines voor meer informatie.

MaxArtifactSize - Maximale grootte van artefact
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 zijn of een geldig pad ten opzichte van de hoofdmap van uw opslagplaats. Het publiceren van artefacten van een Linux- of macOS-agent naar een bestandsshare wordt niet ondersteund. Bijvoorbeeld: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

Parallel - Parallel kopiëren
boolean. Optioneel. Gebruik 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 - Aantal parallellen
string. Optioneel. Gebruik wanneer ArtifactType = FilePath && Parallel = true. Standaardwaarde: 8.

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

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

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

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Notitie

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

Voorbeelden

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

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	1.91.0 of hoger
Taakcategorie	Hulpprogramma

Zie ook

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