PublishPipelineArtifact@1: Aufgabe "Pipelineartefakte veröffentlichen v1"

Verwenden Sie diese Aufgabe, um eine Datei oder ein Verzeichnis als benanntes Artefakt für die aktuelle Ausführung zu veröffentlichen (hochzuladen).

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.

Eingaben

targetPath - Datei- oder Verzeichnispfad
Eingabealias: path. string. Erforderlich. Standardwert. $(Pipeline.Workspace).

Gibt den Pfad der zu veröffentlichenden Datei oder des Verzeichnisses an. Kann absolut oder relativ zum Standardarbeitsverzeichnis sein. Kann Variablen enthalten, aber Platzhalterzeichen werden nicht unterstützt. Weitere Informationen finden Sie unter Artefakte in Azure Pipelines .

artifact - Artefaktname
Eingabealias: artifactName. string.

Gibt den Namen des zu veröffentlichenden Artefakts an. Dies kann ein beliebiger Name sein, den Sie auswählen, z. B drop. . Wenn nicht festgelegt, ist der Standardwert eine eindeutige ID, die auf den Auftrag ausgerichtet ist.

Wichtig

Artefaktname darf nicht enthalten\, /, ", :, <>, |, oder *?.

publishLocation - Artefaktveröffentlichungsort
Eingabealias: artifactType. string. Erforderlich. Zulässige Werte: pipeline (Azure Pipelines), filepath (Eine Dateifreigabe). Standardwert. pipeline.

Gibt an, ob das Artefakt in Azure Pipelines gespeichert oder in eine Dateifreigabe kopiert werden soll, auf die über den Pipeline-Agent zugegriffen werden muss.

fileSharePath - Dateifreigabepfad
string. Erforderlich, wenn artifactType = filepath.

Gibt die Dateifreigabe an, in die die Artefaktdateien kopiert werden. Dies kann Variablen umfassen, z. B \\my\\share\\$(Build.DefinitionName)\\$(Build.BuildNumber). . Das Veröffentlichen von Artefakten aus einem Linux- oder macOS-Agent in einer Dateifreigabe wird nicht unterstützt, z. B \\server\folderName. .

parallel - Paralleles Kopieren
boolean. Optional. Verwenden Sie , wenn artifactType = filepath. Standardwert. false.

Gibt an, ob Dateien parallel mit mehreren Threads kopiert werden sollen, um den potenziellen Durchsatz zu erhöhen. Wenn diese Einstellung nicht aktiviert ist, wird ein Thread verwendet.

parallelCount - Parallele Anzahl
string. Optional. Verwenden Sie , wenn artifactType = filepath && parallel = true. Standardwert. 8.

Gibt den Grad der Parallelität oder die Anzahl der Threads an, die zum Ausführen der Kopie verwendet werden. Der Wert muss zwischen 1 und 128 sein.

properties - Benutzerdefinierte Eigenschaften
string.

Gibt die benutzerdefinierten Eigenschaften an, die dem Artefakt zugeordnet werden sollen. Verwenden Sie eine gültige JSON-Zeichenfolge mit dem Präfix user- für alle Schlüssel.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Die Veröffentlichung wird in klassischen Releasepipelines nicht unterstützt.

Hinweis

Das Veröffentlichen von Pipelineartefakten wird lokal nicht unterstützt. Verwenden Sie Buildartefakte veröffentlichen, wenn Sie Azure DevOps Server oder TFS 2018 verwenden. Wenn Sie es auf Azure DevOps Server verwenden, erhalten Sie eine Fehlermeldung ähnlichPipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead..

Die Schlüsselwörter publish und download sind Abkürzungen für die Aufgaben „PublishPipelineArtifact@1“ und „DownloadPipelineArtifact@2“. Ausführlichere Informationen finden Sie unter steps.publish und steps.download.

Tipp

Sie können die Artefaktignore-Datei verwenden, um zu steuern, welche Dateien veröffentlicht werden.

Ich habe Probleme mit der Veröffentlichung meiner Artefakte. Wie kann ich die detaillierten Protokolle anzeigen?

So aktivieren Sie detaillierte Protokolle für Ihre Pipeline

1. Wählen Sie beim Bearbeiten Ihrer Pipeline Variablen aus.
2. Fügen Sie eine neue Variable mit dem Namen System.Debug und dem Wert true hinzu.
3. Speichern

Welche Variablen stehen mir zur Verfügung?

A: $(Build.SourcesDirectory) und $(Agent.BuildDirectory) sind nur einige der Variablen, die Sie in Ihrer Pipeline verwenden können. Variablen sind als Ausdrücke oder Skripts verfügbar.

Informationen zu den verschiedenen Variablentypen finden Sie unter Definieren von Variablen, Vordefinierte Variablen und Klassische Release- und Artefaktvariablen.

Die Aufgabe ermöglicht es mir, Artefakte im Bereitstellungsauftrag in der yaml-Pipeline zu veröffentlichen, aber ich kann sie nicht in der Downstreampipeline verwenden?

A: Bereitstellungsaufträge verfügen nicht über den Kontext von Quellbranches und sind daher nicht für die Veröffentlichung von Artefakten geeignet. Sie wurden in erster Linie für die Nutzung von Artefakten entwickelt. Ein Lösungsansatz besteht darin, diese Logik in einem separaten Auftrag (mit Abhängigkeiten von Ihren Bereitstellungsaufträgen) zu isolieren.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	2.199.0 oder höher
Aufgabenkategorie	Hilfsprogramm

Weitere Informationen

• Sie möchten mit Buildartefakten beginnen? Weitere Informationen finden Sie unter Artefakte in Azure Pipelines.