PublishPipelineArtifact@1 - Taak Pijplijnartefacten v1 publiceren

Gebruik deze taak om een bestand of map te publiceren (uploaden) als een benoemd artefact voor de huidige uitvoering.

Syntax

# Publish Pipeline Artifacts v1
# Publish (upload) a file or directory as a named artifact for the current run.
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Pipeline.Workspace)' # string. Alias: path. Required. File or directory path. Default: $(Pipeline.Workspace).
    #artifact: # string. Alias: artifactName. Artifact name. 
    publishLocation: 'pipeline' # 'pipeline' | 'filepath'. Alias: artifactType. Required. Artifact publish location. Default: pipeline.
    #fileSharePath: # 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.
    #properties: # string. Custom properties.

Invoerwaarden

targetPath - Pad naar bestand of map
Invoeralias: path. string. Vereist. Standaardwaarde: $(Pipeline.Workspace).

Hiermee geeft u het pad van het bestand of de map te publiceren. Kan absoluut zijn of relatief ten opzichte van de standaardwerkmap. Kan variabelen bevatten, maar jokertekens worden niet ondersteund. Zie Artefacten in Azure Pipelines voor meer informatie.

artifact - Naam van artefact
Invoeralias: artifactName. string.

Hiermee geeft u de naam van het artefact te publiceren. Het kan elke gewenste naam zijn, bijvoorbeeld drop. Als dit niet is ingesteld, is de standaardwaarde een unieke id die binnen het bereik van de taak valt.

Belangrijk

De naam van het artefact mag niet , /, , :, , <, >*|of ?bevatten.\"

publishLocation - Publicatielocatie van artefact
Invoeralias: artifactType. string. Vereist. Toegestane waarden: pipeline (Azure Pipelines), filepath (een bestandsshare). Standaardwaarde: pipeline.

Hiermee geeft u op of het artefact moet worden opgeslagen in Azure Pipelines of dat het moet worden gekopieerd naar een bestandsshare die toegankelijk moet zijn vanuit de pijplijnagent.

fileSharePath - Bestandssharepad
string. Vereist wanneer artifactType = filepath.

Hiermee geeft u de bestandsshare op waar de artefactbestanden worden gekopieerd. Dit kunnen variabelen zijn, bijvoorbeeld \\my\\share\\$(Build.DefinitionName)\\$(Build.BuildNumber). Het publiceren van artefacten van een Linux- of macOS-agent naar een bestandsshare wordt niet ondersteund, bijvoorbeeld \\server\folderName.

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 parallelle uitvoering, of het aantal gebruikte threads, om de kopie uit te voeren. De waarde moet tussen 1 en 128 zijn.

properties - Aangepaste eigenschappen
string.

Hiermee geeft u de aangepaste eigenschappen te koppelen aan het artefact. Gebruik een geldige JSON-tekenreeks met het voorvoegsel user- op alle sleutels.

Opties voor taakbeheer

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

Uitvoervariabelen

Geen.

Opmerkingen

Publiceren wordt niet ondersteund in klassieke releasepijplijnen.

Notitie

Pijplijnartefacten publiceren wordt niet ondersteund in on-premises. Gebruik Build-artefacten publiceren als u Azure DevOps Server of TFS 2018 gebruikt. Als u deze gebruikt voor Azure DevOps Server, ontvangt u een foutbericht dat lijkt op Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead..

De publish trefwoorden en download zijn snelkoppelingen voor de PublishPipelineArtifact@1 en DownloadPipelineArtifact@2 taken. Zie steps.publish en steps.download voor meer informatie.

Tip

U kunt het .artifactignore-bestand gebruiken om te bepalen welke bestanden worden gepubliceerd.

Ik heb problemen met het publiceren van mijn artefacten. Hoe kan ik de gedetailleerde logboeken weergeven?

Gedetailleerde logboeken voor uw pijplijn inschakelen:

1. Bewerk uw pijplijn en selecteer Variabelen
2. Een nieuwe variabele toevoegen met de naam System.Debug en waarde true
3. Opslaan

Welke variabelen zijn beschikbaar voor mij?

A: $(Build.SourcesDirectory) en $(Agent.BuildDirectory) zijn slechts enkele van de variabelen die u in uw pijplijn kunt gebruiken. Variabelen zijn beschikbaar als expressies of scripts.

Zie Variabelen, vooraf gedefinieerde variabelen definiëren en Variabelen voor klassieke release en artefacten voor meer informatie over de verschillende typen variabelen.

Met de taak kan ik artefacten publiceren in de implementatietaak in de yaml-pijplijn, maar ik kan deze niet gebruiken in de downstream-pijplijn?

A: Implementatietaken hebben niet de context van brontakken en zijn daarom niet geschikt voor het publiceren van artefacten. Ze zijn voornamelijk ontworpen om artefacten te verbruiken. Een tijdelijke oplossing is om die logica te isoleren in een afzonderlijke taak (met afhankelijkheden van uw implementatietaken).

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
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	2.199.0 of hoger
Taakcategorie	Hulpprogramma

Zie ook

• Wilt u aan de slag met buildartefacten? Zie Artefacten in Azure Pipelines.