PublishBuildArtifacts@1: Aufgabe "Buildartefakte v1 veröffentlichen"

Artikel
02/01/2023
5 Minuten Lesedauer

Verwenden Sie diese Aufgabe in einer Buildpipeline, um Buildartefakte in Azure Pipelines, TFS oder einer Dateifreigabe zu veröffentlichen.

Syntax

# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
    ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
    publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
    #TargetPath: # 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.
  # Advanced
    #FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options. 
    #StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.

# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
    ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
    publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
    #TargetPath: # 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.
  # Advanced
    #FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options.

# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
    ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
    publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
    #TargetPath: # 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.

# Publish Build Artifacts v1
# Publish build artifacts to Azure Pipelines/TFS or a file share.
- task: PublishBuildArtifacts@1
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
    ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
    publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish location. Default: Container.
    #TargetPath: # 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.

# YAML Syntax is not supported in TFS 2018.
# Use the classic designer to add and configure tasks.
# See the following Inputs section for details on the inputs that this task supports.

Eingaben

PathtoPublish - Zu veröffentlichende Pfad
string. Erforderlich. Standardwert. $(Build.ArtifactStagingDirectory).

Gibt den zu veröffentlichenden Ordner- oder Dateipfad an. Dies kann ein vollqualifizierter Pfad oder ein Pfad relativ zum Stammverzeichnis des Repositorys sein. Platzhalter werden nicht unterstützt. Variablen werden unterstützt. Beispiel: $(Build.ArtifactStagingDirectory). Weitere Informationen finden Sie unter Artefakte in Pipelines – Übersicht.

PathtoPublish - Zu veröffentlichende Pfad
string. Erforderlich.

ArtifactName - Artefaktname
string. Erforderlich. Standardwert. drop.

Gibt den Namen des Artefakts an, das am Veröffentlichungsort erstellt werden soll.

ArtifactName - Artefaktname
string. Erforderlich.

Gibt den Namen des Artefakts an, das am Veröffentlichungsort erstellt werden soll.

publishLocation - Artefakt-Veröffentlichungsort
Eingabealias: ArtifactType. string. Erforderlich. Zulässige Werte: Container (Azure Pipelines), FilePath (Eine Dateifreigabe). Standardwert. Container.

Gibt an, ob das Artefakt in Azure Pipelines (Container) gespeichert oder in eine Dateifreigabe (FilePath) kopiert werden soll, auf die über den Build-Agent zugegriffen werden muss. Weitere Informationen finden Sie unter Artefakte in Azure Pipelines.

publishLocation - Artefakt-Veröffentlichungsort
Eingabealias: ArtifactType. string. Erforderlich. Zulässige Werte: Container (Azure Pipelines/TFS), FilePath (Eine Dateifreigabe). Standardwert. Container.

publishLocation - Artefakt-Veröffentlichungsort
Eingabealias: ArtifactType. string. Erforderlich. Zulässige Werte: Container (Visual Studio Team Services/TFS), FilePath (Eine Dateifreigabe).

TargetPath - Dateifreigabepfad
string. Erforderlich, wenn ArtifactType = FilePath.

Gibt den Pfad zu der Dateifreigabe an, in die Sie die Dateien kopieren möchten. Der Pfad muss ein vollqualifizierter Pfad oder ein gültiger Pfad relativ zum Stammverzeichnis Ihres Repositorys sein. Das Veröffentlichen von Artefakten aus einem Linux- oder macOS-Agent in einer Dateifreigabe wird nicht unterstützt. Beispiel: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

TargetPath - Dateifreigabepfad
string. Optional. Verwenden Sie , wenn ArtifactType = FilePath. Standardwert. \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

Parallel - Paralleles Kopieren
boolean. Optional. Verwenden Sie , wenn ArtifactType = FilePath. Standardwert. false.

Gibt an, ob Dateien parallel mit mehreren Threads kopiert werden sollen, um einen höheren potenziellen Durchsatz zu erzielen. Wenn diese Einstellung nicht aktiviert ist, wird ein einzelner Thread verwendet.

ParallelCount - Parallele Anzahl
string. Optional. Verwenden Sie , wenn ArtifactType = FilePath && Parallel = true. Standardwert. 8.

Gibt den Grad der Parallelität (anzahl der Threads) an, der zum Ausführen des Kopiervorgangs verwendet wird. Der Wert muss mindestens 1 und nicht größer als 128 sein. Wählen Sie einen Wert basierend auf den CPU-Funktionen des Build-Agents aus.

FileCopyOptions - Optionen zum Kopieren von Dateien
string. Optional. Verwenden Sie , wenn ArtifactType = FilePath.

Übergibt zusätzliche Optionen an den Robocopy-Befehl. Beispiel: das rekursive Minimatch-Muster **/*.

StoreAsTar - Tarieren des Artefakts vor dem Hochladen
boolean. Standardwert. false.

Fügt vor dem Hochladen alle Dateien aus dem Veröffentlichungspfad zu einem TAR-Archiv hinzu. Dadurch können Sie die UNIX-Dateiberechtigungen beibehalten. Verwenden Sie extractTars die Option derDownloadBuildArtifacts-Aufgabe , um die heruntergeladenen Elemente automatisch zu extrahieren. Diese Einstellung wird auf Windows-Agents ignoriert.

Aufgabensteuerungsoptionen

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

Ausgabevariablen

Keine.

Hinweise

Hinweis

Sie können bin, App_Data und andere von IIS reservierte Ordnernamen nicht als Artefaktnamen verwenden, da dieser Inhalt nicht als Reaktion auf Webanforderungen bereitgestellt wird. Weitere Informationen finden Sie unter ASP.NET Webprojektordnerstruktur .

Beispiele

steps:
- task: CopyFiles@2
  inputs:
    contents: '_buildOutput/**'
    targetFolder: $(Build.ArtifactStagingDirectory)
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: $(Build.ArtifactStagingDirectory)
    artifactName: MyBuildOutputs

Anforderungen

Anforderung	Beschreibung
Pipelinetypen	YAML, Klassischer Build
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	1.91.0 oder höher
Aufgabenkategorie	Hilfsprogramm

Siehe auch

Referenz zu Dateiabgleichsmustern
Gewusst wie verwenden Sie diese Aufgabe, um Artefakte zu veröffentlichen.
Erfahren Sie, wie Sie ausführliche Protokolle für die Problembehandlung verwenden.