PublishPipelineArtifact@1 - Pijplijnartefacten v1-taak publiceren

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

Syntaxis

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

Invoer

targetPath - bestands- of mappad
Invoeralias: path. string. Verplicht. Standaardwaarde: $(Pipeline.Workspace).

Hiermee geeft u het pad van het bestand of de map die moet worden gepubliceerd. Kan absoluut of relatief zijn ten opzichte van de standaardwerkmap. Kan variabelenbevatten, maar jokertekens worden niet ondersteund. Zie Artifacts in Azure Pipelines voor meer informatie.

naam van artifact - artefact
Invoeralias: artifactName. string.

Hiermee geeft u de naam op van het artefact dat moet worden gepubliceerd. Dit kan elke naam zijn die u kiest, bijvoorbeeld drop. Als deze niet is ingesteld, is de standaardwaarde een unieke id die is afgestemd op de taak.

Belangrijk

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

publishLocation - locatie voor publiceren van artefacten
Invoeralias: artifactType. string. Verplicht. Toegestane waarden: pipeline (Azure Pipelines), filepath (A-bestandsshare). Standaardwaarde: pipeline.

Hiermee geeft u op of het artefact moet worden opgeslagen in Azure Pipelines of 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 waarin de artefactbestanden worden gekopieerd. Dit kan 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. 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 er één thread gebruikt.

parallelCount - parallelle telling
string. Facultatief. Gebruiken wanneer artifactType = filepath && parallel = true. Standaardwaarde: 8.

Hiermee geeft u de mate van parallellisme of het aantal gebruikte threads op om de kopie uit te voeren. De waarde moet tussen 1 en 128 zijn.

properties - aangepaste eigenschappen
string.

Hiermee geeft u de aangepaste eigenschappen die aan het artefact moeten worden gekoppeld. Gebruik een geldige JSON-tekenreeks met het voorvoegsel user- op alle sleutels.

Opties voor taakbeheer

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

Uitvoervariabelen

Geen.

Opmerkingen

Publiceren wordt niet ondersteund in klassieke release-pijplijnen.

Notitie

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

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

Hint

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

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

Gedetailleerde logboeken voor uw pijplijn inschakelen:

1. Bewerk uw pijplijn en selecteer Variabelen
2. Voeg een nieuwe variabele toe met de naam System.Debug en waarde true
3. opslaan

Welke variabelen zijn voor mij beschikbaar?

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 definiëren, vooraf gedefinieerde variabelenen klassieke release- en artefactvariabelen voor meer informatie over de verschillende typen variabelen.

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

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

Vereisten

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

Zie ook

• Wilt u aan de slag met buildartefacten? Bekijk artefacten in Azure Pipelines.