CopyPublishBuildArtifacts@1 – Aufgabe "Buildartefakte kopieren und veröffentlichen" v1

Artikel
03/24/2025

Verwenden Sie diese Aufgabe, um Buildartefakte in einen Stagingordner zu kopieren und sie dann auf dem Server oder einer Dateifreigabe zu veröffentlichen. Dateien werden in den $(Build.ArtifactStagingDirectory) Stagingordner kopiert und dann veröffentlicht.

Wichtig

Diese Aufgabe ist veraltet. Es wird empfohlen, Pipelineartefakte und die aufgabe "Dateien kopieren" und stattdessen die aufgabe Buildartefakte veröffentlichen zu verwenden.

Syntax

# Copy and Publish Build Artifacts v1
# CopyPublishBuildArtifacts@1 is deprecated. Use the Copy Files task and the Publish Build Artifacts task instead.
- task: CopyPublishBuildArtifacts@1
  inputs:
    #CopyRoot: # string. Copy Root. 
    Contents: # string. Required. Contents. 
    ArtifactName: # string. Required. Artifact Name. 
    ArtifactType: # 'Container' | 'FilePath'. Required. Artifact Type. 
    #TargetPath: '\\my\share\$(Build.DefinitionName)\$(Build.BuildNumber)' # string. Optional. Use when ArtifactType = FilePath. Path. Default: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

Eingänge

CopyRoot - Stamm- kopieren
string.

Der Ordner, der die Dateien enthält, die Sie kopieren möchten. Wenn der Ordner leer ist, kopiert die Aufgabe Dateien aus dem Stammordner des Repositorys, als ob $(Build.SourcesDirectory) angegeben wurde.

Wenn Ihr Build Artefakte außerhalb des Quellverzeichnisses erzeugt, geben Sie $(Agent.BuildDirectory) an, um Dateien aus dem Arbeitsverzeichnis des Build-Agents zu kopieren.

Contents - Inhalte
string. Erforderlich.

Gibt Musterfilter (eine in jeder Zeile) an, die Sie auf die Liste der zu kopierenden Dateien anwenden möchten. Beispiel:

** kopiert alle Dateien im Stammordner.
**\* kopiert alle Dateien im Stammordner und alle Dateien in allen Unterordnern.
**\bin kopiert Dateien in einen beliebigen Unterordner mit dem Namen bin.

ArtifactName - Artefaktname
string. Erforderlich.

Gibt den Namen des zu erstellenden Artefakts an.

ArtifactType - Artefakttyp
string. Erforderlich. Zulässige Werte: Container (Server), FilePath (Dateifreigabe).

Gibt an, ob das Artefakt auf TFS/Team Services gespeichert oder in eine Dateifreigabe kopiert werden soll, auf die über den Build-Agent zugegriffen werden muss.

TargetPath - Pfad-
string. Wahlfrei. Wird verwendet, wenn ArtifactType = FilePath. Standardwert: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

Der Speicherort des UNC-Dateipfads, an dem das Artefakt kopiert wird. Der Zugriff muss über den Build-Agent erfolgen.

Aufgabensteuerungsoptionen

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

Ausgabevariablen

Keiner.

Bemerkungen

Wichtig

Diese Aufgabe ist veraltet. Es wird empfohlen, Pipelineartefakte und die aufgabe "Dateien kopieren" und stattdessen die aufgabe Buildartefakte veröffentlichen zu verwenden.

Dieser Schritt hat nicht das Ergebnis erzeugt, das ich erwartet habe. Wie kann ich es beheben?

Diese Aufgabe weist einige bekannte Probleme auf:

Einige Miniübereinstimmungsmuster funktionieren nicht.
Dadurch wird der am häufigsten verwendete Stammpfad für alle übereinstimmenen Pfade entfernt.

Sie können diese Probleme vermeiden, indem Sie stattdessen die aufgabe "Dateien kopieren" und die aufgabe "Buildartefakte veröffentlichen"verwenden.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, klassischer Build
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	1.83.0 oder höher
Vorgangskategorie	Nützlichkeit

Freigeben über