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 (hochladen).

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.

Eingänge

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 Variablenenthalten, jedoch werden keine Wildcards 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. Es kann sich um einen beliebigen Namen, den Sie auswählen, z. B. drop. Wenn sie nicht festgelegt ist, ist die Standardeinstellung eine eindeutige ID, die auf den Auftrag festgelegt ist.

Wichtig

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

publishLocation - Artefakt-Veröffentlichungsort
Eingabealias: artifactType. string. Erforderlich. Zulässige Werte: pipeline (Azure Pipelines), filepath (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 enthalten, z. B. \\my\\share\\$(Build.DefinitionName)\\$(Build.BuildNumber). Das Veröffentlichen von Artefakten von einem Linux- oder macOS-Agent in einer Dateifreigabe wird nicht unterstützt, z. B. \\server\folderName.

parallel - parallele Kopie
boolean. Wahlfrei. Wird verwendet, 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. Wahlfrei. Wird verwendet, wenn artifactType = filepath && parallel = true. Standardwert: 8.

Gibt den Grad der Parallelität oder die Anzahl der verwendeten Threads an, um die Kopie auszuführen. 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.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

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

Hinweis

Veröffentlichen von Pipelineartefakten wird in lokalen Bereitstellungen 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, wird eine Fehlermeldung wie Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead.angezeigt.

Die Schlüsselwörter publish und download sind Tastenkombinationen für die aufgaben PublishPipelineArtifact@1 und DownloadPipelineArtifact@2. Weitere Informationen finden Sie unter steps.publish und steps.download.

Tipp

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

Ich habe Probleme beim Veröffentlichen meiner Artefakte. Wie kann ich die detaillierten Protokolle anzeigen?

So aktivieren Sie detaillierte Protokolle für Ihre Pipeline:

1. Bearbeiten Sie Ihre Pipeline, und wählen Sie Variablen
2. Hinzufügen einer neuen Variablen mit dem Namen System.Debug und wert true
3. Speichern

Welche Variablen sind für mich verfügbar?

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.

Weitere Informationen zu den verschiedenen Variablentypen finden Sie unter Definieren von Variablen, vordefinierten Variablensowie Variablen für klassische Freigabe- und Artefakte.

Die Aufgabe ermöglicht mir, Artefakte im Bereitstellungsauftrag in der Yaml-Pipeline zu veröffentlichen, aber ich bin nicht in der Lage, sie in der downstream-Pipeline zu verwenden?

A: Bereitstellungsaufträge verfügen nicht über den Kontext von Quellzweigen und sind daher nicht für die Veröffentlichung von Artefakten geeignet. Sie wurden in erster Linie für die Nutzung von Artefakten entwickelt. Eine Problemumgehung wäre das Isolieren dieser Logik in einen separaten Auftrag (mit Abhängigkeiten von Ihren Bereitstellungsaufträgen).

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	2.199.0 oder höher
Vorgangskategorie	Nützlichkeit

Siehe auch

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