PublishBuildArtifacts@1 – Buildartefakte v1-Aufgabe veröffentlichen

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

Wenn Sie Azure DevOps Services verwenden, empfehlen wir die Verwendung Herunterladen von Pipelineartefakten und Veröffentlichen von Pipelineartefakten für eine schnellere Leistung.

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.
    #MaxArtifactSize: '0' # string. Max Artifact Size. Default: 0.
    #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
    #StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.

Eingänge

PathtoPublish - Pfad zum Veröffentlichen von
string. Erforderlich. Standardwert: $(Build.ArtifactStagingDirectory).

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

ArtifactName - Artefaktname
string. Erforderlich. Standardwert: drop.

Gibt den Namen des Artefakts an, das am Veröffentlichungsort erstellt werden soll. Die folgenden Sonderzeichen sind nicht zulässig: +, %, {, }

publishLocation - Artefakt-Veröffentlichungsort
Eingabealias: ArtifactType. string. Erforderlich. Zulässige Werte: Container (Azure Pipelines), FilePath (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. Der Eingabealias: ArtifactType ist ein alternativer Name für publishLocation und kann austauschbar verwendet werden. Weitere Informationen finden Sie unter Artefakte in Azure Pipelines.

MaxArtifactSize - max. Artefaktgröße
string. Standardwert: 0.

Maximale Grenze für die Größe von Artefakten, die in Bytes veröffentlicht werden sollen. Setzen Sie 0, wenn Sie keinen Grenzwert festlegen möchten.

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

Gibt den Pfad zur 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 von einem Linux- oder macOS-Agent in einer Dateifreigabe wird nicht unterstützt. Beispiel: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

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 einzelner Thread verwendet.

ParallelCount - parallele Anzahl
string. Wahlfrei. Wird verwendet, wenn ArtifactType = FilePath && Parallel = true. Standardwert: 8.

Gibt den Grad der Parallelität (die Anzahl der Threads) an, die zum Ausführen der Kopie verwendet werden. 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.

StoreAsTar - Tar das Artefakt vor dem Hochladen von
boolean. Standardwert: false.

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

Optionen für die Vorgangskontrolle

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

Ausgabevariablen

Keiner.

Bemerkungen

Hinweis

Sie können Bin, App_Data und andere Ordnernamen, die von IIS als Artefaktnamen reserviert sind, nicht verwenden, da dieser Inhalt nicht als Reaktion auf Webanforderungen bereitgestellt wird. Weitere Informationen finden Sie unter ASP.NET Web Project Folder Structure.

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
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.91.0 oder höher
Vorgangskategorie	Nützlichkeit

Siehe auch

• Referenz zu Dateiabgleichsmustern
• Wie verwende ich diese Aufgabe zum Veröffentlichen von Artefakten
• Erfahren Sie, wie Sie ausführlichen Protokolle für Problembehandlungverwenden.